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PREFACE 

MANUAL OBJECTIVES 

The VAX-11/750 Software Installation Guide presents step-by-step 
procedures for installing software on a VAX-11/750 processor. 
VAX-11/750 software installation falls into three general categories: 

• Installing software on a newly purchased VAX/VMS system 

• Applying system maintenance updates to a VAX/VMS system 

• Upgrading an existing VAX/VMS system 



INTENDED AUDIENCE 

This manual is intended for those users who are responsible for 
managing and controlling the operating system. 



STRUCTURE OF THIS DOCUMENT 

This manual is divided into the following chapters and appendixes: 

• Chapter 1, Overview of Software Installation, briefly 
describes the process of bootstrapping and installing a 
VAX/VMS operating system and describes the VAX-11/750 console 
subsystem. 

• Chapter 2, Building a Bootable System Disk, describes the 
procedures for restoring the software distribution kit to a 
bootable format. 

• Chapter 3, Site-Specific Modifications to VAX/VMS, describes 
how to make modifications to VAX/VMS so that it more closely* 
fits your site's needs. 

• Chapter 4, The VMSINSTAL Command Procedure, describes how to 
use VMSINSTAL.COM to install system maintenance updates, 
optional software products, and EDTCAI. 

• Chapter 5, The System After Installation, describes different 
procedures that can be performed after installation. These 
include backing up the console TU58 cartridge, booting the 
system after installation, building and copying a VAX/VMS 
system disk, and building a stand-alone BACKUP kit. 

• Appendix A, Files of the VAX/VMS System, lists the 
DIGITAL-supplied directories on the system disk and their 
contents . 



Vll 



PREFACE 



Appendix B, Using the TU58 Tape Cartridge, describes in detail 
the steps to be taken when bootstrapping the system using the 
TU58 tape cartridge as the primary bootstrap device. 

Appendix C, BOOT58 Commands, describes the commands that can 
be entered to the stand-alone BOOT58 program. 

Appendix D, Micro Verify Error Characters, describes micro 
verify routines that test the reliability of VAX-11/750 
hardware . 

Appendix E, Installing Optional Software Products, describes 
the VMSUPDATE.COM command procedure used to install some 
optional software products. 

Appendix F, Building the VAX/VMS Source Kit, describes the 
steps to be taken to copy the VAX/VMS source kit. 

Appendix G, Upgrading the System, describes the steps required 
to upgrade a system from a Version 2.5 system to a 3.0 system. 

Appendix H, VMSINSTAL Error Messages, describes the error 
messages issued by the VMSINSTAL command procedure. 



ASSOCIATED DOCUMENTS 

There are no prerequisites to using this document, but it is strongly 
recommended that you read the VAX /VMS Release Notes supplied with 
Versions 3.0, 3.1 and 3.2, for the most current information about 
VAX/VMS before installing software. 

In addition, an understanding of the information presented in the 
VAX/VMS Summary Description and Glossary and the VAX/VMS Command 
Language User 's Guide may prove helpful. 

The following documents, which are referred to in this manual, provide 
the information needed to manage the day-to-day operation of the 
VAX/VMS system once it is initialized. 

• VAX/VMS System Management and Operations Guide 

• V&X-11 Utilities Reference Manual 

For a complete list and description of VAX-11 documents, including 
optional software product documents, see the VAX-11 Information 
Directory and Index . 

Further documentation on installing optional software products is 
included with each optional software product. 
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PREFACE 

CONVENTIONS USED IN THIS DOCUMENT 

Convention Meaning 

(ret) A symbol with a one- to three-character 

abbreviation indicates that you press a key on 
the terminal, for example, (ret). 

CTRL/x The phrase CTRL/x indicates that you must 

press the key labeled CTRL while you press 
another key, for example CTRL/C, CTRL/Y. 

$ SHOW TIME Command examples show all output lines or 

prompting characters that the system prints or 
displays in black letters. All user-entered 
commands are shown in red letters. 

file-spec,... Horizontal ellipsis indicates that additional 

parameters, values, or information can be 
entered . 



IX 



SUMMARY OF TECHNICAL CHANGES 



The following technical changes have been made to the VAX-11/750 
Software Installation Guide for Version 3.2: 

• Chapter 4, The VMSINSTAL Command Procedure, has been rewritten 
to reflect significant changes and additions to the VMSINSTAL 
command procedure. 

• The procedure for upgrading a Version 2.5 VAX/VMS system to a 
Version 3.0 VAX/VMS system has been moved to Appendix G. 

• Appendix H, VMSINSTAL Error Messages, has been added to 
explain error messages issued by the VMSINSTAL command 
procedure. 

• Installation information about RA60 disks has been added. 

• Information about remastered distribution kits has been added. 
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CHAPTER 1 
OVERVIEW OF SOFTWARE INSTALLATION 

There are three general categories of VAX-11/750 software 
installation : 

• Bootstrapping and installing a newly purchased VAX/VMS system 

• Applying system maintenance updates to a VAX/VMS system 
Upgrading an existing VAX/VMS system 



• 



w 



Installation refers to setting up a VAX/VMS operating system on a ne 
VAX-11/750 processor. Updating refers to applying system maintenance 
updates, and consists primarily of a set of patches distributed on 
TU58 cartridges. Upgrading refers to bringing a Version 2.5 system up 
to the next ma^or version, Version 3.0, and is done substantially by 
file replacement. 

All installation procedures are performed using the VAX-11/750 console 
subsystem. 



1.1 VAX-11/750 CONSOLE SUBSYSTEM 

The console subsystem consists of three hardware components (a console 
terminal, a TU58 cartridge drive, and an optional remote diagnostics 
port) and a microcode program. These hardware components and the 
microcode program perform the actual bootstrap operation based on: 

(1) the positions of the switches on the processor control panel, and 

(2) the interactive commands entered at the console terminal. 

You can request that the system be bootstrapped in either of the 
following ways: 

• Directly from the system disk 

• Using the stand-alone BOOT58 program on the TU58 cartridge 

Both methods require the assistance of the console subsystem. The 
recommended approach for daily operation is from the system disk with 
the TU58 cartridge as backup. Using the first method, you issue a 
BOOT command to the console subsystem to bootstrap the system from a 
particular device. Using the second method, you issue a BOOT command 
to the console subsystem to bootstrap the stand-alone BOOT58 program. 
With stand-alone BOOT58, you can then bootstrap the system by 
specifying either stand-alone BOOT58 commands or a command procedure 
stored on the console TU58 cartridge. (See Appendix B for more 
information on the BOOT58 program.) 

Figure 1-1 shows a diagram of the basic console subsystem. 
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Figure 1-1: VAX-11/750 Console Subsystem 



1.2 VAX-11/750 PROCESSOR CONTROL PANEL 

The VAX-11/750 processor control panel consists of seven indicator 
lights, four switches, and the TU58 cartridge drive. These switches 
and indicator lights reflect the current state of the system and 
dictate how the system will react to initial bootstrapping, shutdowns, 
and restarts. Figure 1-2 shows a diagram of a VAX-11/750 processor 
control panel. 



1.2.1 Indicator Lights 

There are seven indicator lights on the processor front panel: the 
first three indicate the state of the processor, and the remaining 

four indicate the state of the remote diagnostic procedures. 

CPU State Indicators 



POWER 



RUN 



ERROR 



When lit, this green light indicates that the 
power is present in the processor and that the 
keyswitch is in the ON position. 



When lit, this green 
processor is running. 



light indicates that the 



When dimly lit, this red light indicates the 
processor is running normally. When brightly lit, 
this red light indicates that the processor has 
experienced an unrecoverable error. Push the 
white INITIALIZE button to reset the machine. 
(The ERROR light will remain dimly lit.) During 
normal operation, if the light is not on at all, 
the bulb has burned out. 
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Figure 1-2: The VAX-11/750 Processor Control Panel 



Remote Diagnostic Indicators 

The remote diagnostic indicator lights are invisible until they are 
lit on a machine that has a remote diagnostic ROM installed. 



REMOTE D 



RD FAULT 



RD TEST 



RD CARRIER 



When lit, this red light indicates that the 
keylock rotary switch is in the REMOTE position. 

When lit for more than ten seconds, this red light 
indicates that the remote diagnostic ROM has 
detected an error. When a machine that has a 
remote diagnostic ROM is powered up, this light 
will come on for about ten seconds, to indicate 
that a self test is in progress. 

When lit, this green light indicates that the 
remote host connection has been made with 
successful protocol exchange. 

When lit, this amber light indicates that a 
carrier signal is present on a dial-in line. 



1.2.2 POWER-ON-ACTION Switch 

The POWER-ON-ACTION switch controls the processor's power-up sequence. 
The processor interprets and acts on the position of the 
POWER-ON-ACTION switch in the following situations: 

• After an orderly shutdown 

• After a brief power failure 

• After the microcode detects a halt condition (for example, a 
HALT instruction executed in kernel mode) 

The POWER-ON-ACTION switch has four positions that instruct the 
processor how to power up the system. The instructions are: 



BOOT 



RESTART/BOOT 



HALT 



RESTART/HALT 



Bootstraps the system from the device selected by 
the BOOT DEVICE switch. 

Restarts the system. If the restart fails (if 
memory battery backup fails during a power 
failure, for example) , bootstraps the system from 
the device selected by the BOOT DEVICE switch. 

Halts the system and displays the console prompt 
(>>>) at the console terminal. 

Restarts the system. If the restart fails, halts 
the system. 
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During normal system operation, the POWER-ON-ACTION switch should be 
set to the RESTART/BOOT position. This switch setting provides for 
the most comprehensive system recovery procedure. 



1.2.3 BOOT DEVICE Switch 

The BOOT DEVICE switch can be used to select the system's bootstrap 
device. The processor interprets and acts on the position of the BOOT 
DEVICE switch in the following situations: 



• When you issue the console BOOT command without 
device name 



specifying a 



• When the system attempts an automatic bootstrap 

In both situations, the processor examines the BOOT DEVICE switch and 
assumes that the controller character is A and that the unit number of 
the drive is 0. 

The BOOT DEVICE switch has four positions: A, B, C, and D. Position 
A always causes the system to bootstrap from the TU58 cartridge drive. 
Positions B, C, and D correspond to the remaining disk controllers. 
Consult your local field service representative to determine how the 
positions correspond to the available disk controllers. Typically, 
you should set the BOOT DEVICE switch to the position corresponding to 
your system disk. 



1.2.4 INITIALIZE Button 

When you press the white INITIALIZE button, the system performs an 
automatic shutdown followed by a power-up sequence without disturbing 
the contents of memory. The system determines the power-up action by 
examining the position of the POWER-ON-ACTION switch. 



1.2.5 Keylock Rotary Switch 

The keylock rotary switch controls the actions of the processor and 
the console subsystem. 



OFF 
SECURE 



Power is off. 

Processor can be run; however, the console 
commands, remote diagnostic line, and INITIALIZE 
button are disabled. 



LOCAL 



Processor can respond to console commands, and the 
remote diagnostic line is disabled. 



REMOTE/SECURE Console commands and the INITIALIZE button are 
disabled, and the optional remote diagnostic line 
replaces the console terminal. 



REMOTE 



Console commands are disabled; however, they can 
be activated by means of the optional remote 
diagnostic line. 
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1.3 OVERVIEW OF SYSTEM INSTALLATION 

Installation can be performed by any system user who has access to the 
console terminal. 

To bootstrap and install a VAX/VMS operating system, perform the 
following steps at the console terminal: 

1. Restore the required save set (the files required for a 
bootable system) from the distribution kit to disk, using the 
stand-alone version of the Backup Utility (BACKUP). 

2. Bootstrap the system. 

(When booting, additional files will be restored from the 
distribution kit. These files are referred to as the library 
and optional save sets.) 

3. Shut down the system and reboot. 

4. Run the User Environment Test Package (UETP) . 

This installation process is restartable at any point. Steps one and 
two are described in Chapter 2, Building a Bootable System Disk. 
Steps three and four are described in Chapter 3, Site-Specific 
Modifications to VAX/VMS. 

The updating procedure is described in Chapter 4. The upgrading 
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CHAPTER 2 
BUILDING A BOOTABLE SYSTEM DISK 



The VAX-11/750 software distribution kit for the VAX/VMS operating 
system contains the following: 

• The distribution tape, RK07 disk, RA60 disk, or RL02 disk(s) 

• Two TU58 cartridges containing stand-alone BACKUP (only with 
magnetic tape distribution kits; RK07, RA60, and RL02 
distribution kits contain two blank TU58 cartridges to be used 
in creating a stand-alone BACKUP kit) 

• One blank TU58 cartridge to be used in creating a new console 
TU58 

The distribution ta^e or disks contains all the files needed to create 
a VAX/VMS operating system. However, as they exist in the 
distribution kit, the VAX/VMS files are split into three groups called 
BACKUP save sets. The save sets are in a compressed format and do not 
comprise a usable system. The files in the save sets must be restored 
to another disk, using the stand-alone Backup Utility that is 
contained on the distribution disk (or on TU58 cartridge for magnetic 
tape distribution kits). The restoration process reformats the files 
into a usable VAX/VMS system. 

The three save sets are composed of different types of files. One 
save set contains all the files required for a bootable system; the 
others consist of the VAX/VMS library and VAX/VMS optional files. 

NOTE 

Only new installation sites using the 
VAX/VMS Version 3.2 remastered 
distribution kit should install their 
system using the instructions in this 
chapter. If you are already operating 
on a VAX/VMS Version 3 operating system, 
you must perform updates to your system 
using the instructions in Chapter 4 of 
this manual. If you are operating on a 
VAX/VMS Version 2.5 operating system or 
lower, see Appendix G. 



2.1 OVERVIEW OF BUILDING A BOOTABLE SYSTEM DISK 

There are four steps to building a bootable system disk: 

1. Stand-alone BACKUP is booted, either from the RK07 disk for 
RK07 distribution kits, from the RA60 disk for RA60 
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distribution kits, from the primary distribution disk for the 
RL02 distribution kits, or from the TU58 cartridges for 
magnetic tape distribution kits. 

2. Stand-alone BACKUP restores the required save set from the 
distribution kit to the target disk, creating a kernel 
VAX/VMS system. 

3. The kernel VAX/VMS system is booted. 

4. Once booted, the kernel VAX/VMS system restores the library 
and optional save sets from the distribution kit to the 
target disk. On RL02/RA80 configurations the optional save 
set is distributed on a separate RL02 disk and may be 
restored at a later date, if desired. 

Before you can build a bootable system disk, you must verify that you 
have received all needed VAX/VMS V3. 2 software. You must also know 
how to specify device names and power up the system. Sections 2.2 
through 2.4 describe these procedures in detail. 



2.2 VAX/VMS SOFTWARE DISTRIBUTION KITS 

VAX/VMS software for the VAX-11/750 is distributed on either an RK07 
disk, an RA60 disk, two RL02 disks, or on magnetic tape. 

The bill of materials that comes with the kit lists the entire 
contents of that kit. Check to make sure you have received everything 
1 isted . 

In addition to the materials contained in the software distribution 
kit, you will also need a console TU58 cartridge before you can 
proceed with an installation or upgrade. If you are a new customer, 
the console TU58 cartridge was shipped with the hardware. For other 
customers, your current console TU58 cartridge will be upgraded as 
part of the VAX/VMS upgrade procedure. 



2.2.1 Magnetic Tape Kit 

The VAX-11/750 magnetic tape software distribution kit contains the 
following : 

• The VAX/VMS Version 3.2 distribution tape 

Part number: BB-D782F-BE 

Part description: VAX/VMS V3.2 BIN 16MT9 

• Two TU58 cartridges that contain stand-alone BACKUP 

Part number: BE-M757A-BE 

Part description: V3. 2 S/A BKUP T58 1/2 

Part number: BE-M758A-BE 

Part description: V3. 2 S/A BKUP T58 2/2 
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• One blank TU58 cartridge to be used in creating a new console 
TU58 

Part number: 36-15809-00 

Part description: BLANK TU58 CASSETTE 

2.2.2 RK07 Kit 

The VAX-11/750 RK07 software distribution kit contains the following: 

• The RK07 Version 3.2 distribution disk 

Part number: AY-H020F-BE 

Part description: VAX/VMS V3. 2 BIN RK7 

• Three blank TU58 cartridges: two to be used in creating a 
stand-alone BACKUP kit, one to be used in creating a new 
console TU58 

2.2.3 RA60 Kit 

The VAX-11/750 RA60 software distribution kit contains the following: 

• The RA60 Version 3.2 distribution disk 

Part number: BD-R379A-EE 

Part description: VAX/VMS V3.2 BIN RA6 

• Three blank TU58 cartridges: two to be used in creating a 
stand-alone BACKUP kit, one to be used in creating a new 
console TU58 

2.2.4 RL02 Kit 

The VAX/VMS operating system on an RL02/RA80 configuration is 
distributed on two separate RL02 disks: 

• A primary distribution disk 

• An optional distribution disk 

The primary distribution disk contains the files needed to create a 
VAX/VMS operating system. 

It consists of two BACKUP save sets that are composed of different 
types of files. One save set contains all the files required for a 
bootable system, and the other consists of the VAX/VMS library files. 

The optional distribution disk contains additional pieces of the 
VAX/VMS operating system, including compatibility mode files, VAX-11 
BLISS files, programming examples, and miscellaneous other files. The 
optional disk also contains the EDTCAI course, which is not part of 
the operating system. The optional distribution disk may be restored 
either at installation time or at a later date. 
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2.2.4.1 The Primary Software Distribution Disk - To restore both the 
files required for a bootable system and the VAX/VMS library files, 
you need the following: 

• The VAX/VMS Version 3.2 primary distribution disk 
Part number: BC-M761B-BE 

Part description: VAX/VMS V3. 2 REQUIRED RL2 

• Three blank TU58 cartridges 

The three blank TU58 cartridges are provided for building stand-alone 
BACKUP and copying the console media. Procedures for both of these 
operations are described in Chapter 4. 



2.2.4.2 The Optional Software Distribution Disk - To restore the 
optional VAX/VMS files, you need the following: 

• The VAX/VMS Version 3.2 optional distribution disk 
Part number: BC-M762B-BE 

Part description: VAX/VMS V3. 2 OPTIONAL RL2 

2.3 SPECIFYING DEVICE NAMES 

You will need to specify a device name twice in order to build a 
bootable system disk: once when specifying the location of the target 
disk for the required save set, and once when responding to the data 
prompt asking which device is holding the distribution kit. 

All hardware devices supported on a VAX/VMS system have a device type 
code. Examples of these codes are listed in Table 2-1. 

The device name identifies the physical device on which a file is 
stored. The device name contains three fields, in the format ddcu: 

• The device type (dd) . For example, an RK07 disk is DM and a 
TE16 magnetic tape is MT. 

• A controller designator (c) . The controller designator 
identifies the hardware controller to which the device is 
attached. The first or only controller is always designated 
A. 

• The unit number (u) . The unit number button on the front 
panel of the disk drive uniquely identifies a particular 
device unit. 

Some examples of device names are: 

Name Device 

DMA2 RK07 disk on controller A, unit 2 

DLA1 RL02 disk on controller A, unit 1 

MTAO TE16 magnetic tape on controller A, unit 

DUA10 RA81 disk on UDA controller A, unit 10 
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Table 2-1: Device Type Codes 



Code Device Type 



CS Console Storage Device 

DB RP05, RP06 Disks 

DD TU58 Cartridge Tape 

DL RL02 Cartridge Disk 

DM RK06, RK07 Cartridge Disks 

DR RM03, RM05, RM80, RP07 Disks (See note below) 

DU RA60, RA80, RA81 Disks 

DY RX02 Floppy Diskette 

LP Line Printer on LP11 

MF TU78 Magnetic Tape 

MS TS11 Magnetic Tape 

MT TE16, TU45, TU77 Magnetic Tapes 

OP Operator's Console 

RT Remote Terminal 

TT Interactive Terminal on DZ11 



NOTE: When booting any of these devices at the console program prompt 
(>>>), use the mnemonic DB . 



2.4 POWERING UP THE SYSTEM 

To power up the system, check the switches and panel indicators and 
see that you have the console prompt (>>>). 



2.4.1 Checking the Switches and Panel Indicators 

To power up the system, the following switches should be in the 
positions indicated: 

• The ON-OFF power switch on the console terminal: ON 

• The POWER-ON-ACTION switch on the processor control 
panel: HALT 

• The rotary key switch on the processor control panel: LOCAL 
Also, be sure the POWER control panel indicator is lit. 
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2.4.2 Checking for the Attention of the Console Program 

See that you have the attention of the console program by checking for 
the three-angle-bracket (>>>) prompt. If this prompt does not appear, 
perform the following steps: 

1. Make sure the POWER-ON-ACTION switch is in the HALT position. 

2. Make sure the rotary key is in the LOCAL position. 

3. If the power is already on, press CTRL/P to cause the console 
program to prompt with three angle brackets (>>>). 



2.5 RESTORING THE DISTRIBUTION KIT 

The first step in restoring the distribution kit is loading 
stand-alone BACKUP. When stand-alone BACKUP is loaded, use it to 
restore the required save set to the target disk. Once booted, the 
kernel VAX/VMS system that is created automatically restores the 
library and optional save sets to the target disk. 

If you receive any error messages during installation, refer to the 
VAX/VMS System Messages and Recovery Procedures Manual. 



2.5.1 Loading Stand-alone BACKUP 

Stand-alone BACKUP can be loaded from either the RK07 disk (RK07 

distribution kits) , the RA60 disk (RA60 distribution kits) , the 

primary RL02 disk (RL02 distribution kits) , or from the TU58 
cartridges (magnetic tape distribution kits). 



2.5.1.1 Loading Stand-alone BACKUP from Disk - The procedure for 
loading stand-alone BACKUP from a disk is as follows: 

1. Place the distribution disk in the appropriate drive. Sites 
using the RL02 distribution kit must use the primary 
distribution disk in this step. Write protect the disk by 
pressing the WRITE PROTECT button, and spin it up by pressing 
the RUN button or the LOAD button, depending on the drive you 
are using. 

2. At the console prompt, boot stand-alone BACKUP by typing a 
"B" with the appropriate device type. For example, the 
following boots an RK07 disk: 

>>> B DMcu 

(where c is the controller letter and u is the unit number) 

Two percent signs (%%) will appear on the console terminal. 

3. After about 10 seconds, you will observe the following 
message and DIGITAL Command Language (DCL) prompt ($) on the 
console terminal 

VAX/VMS Version V3. 2 <date hh:mm> 
$ 
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2.5.1.2 Loading Stand-alone BACKUP from TU58 Cartridge - If you have 

a magnetic tape distribution kit, you will be booting BACKUP from TU58 

cartridge. The procedure for loading stand-alone BACKUP from TU58 
cartridges is as follows: 

1. Place the distribution tape on a magnetic tape drive. Press 
the LOAD button. When the tape has loaded, press the ONLINE 
button. 

2. Insert the BACKUP TU58 marked VAX/VMS V3. S/A BKUP T58 1/2. 

3. At the console prompt, type: 

>>> B DDAO 

4. When BACKUP has finished loading the first TU58, after 
approximately 15 minutes, you will receive this message: 

VAX/VMS Version V3. 2 <date hh:mm> 

Please mount second stand-alone system diskette or 
cartridge and press RETURN. 

5. Remove the first stand-alone BACKUP TU58, replace it with the 
second stand-alone BACKUP TU58 marked VAX/VMS V3. S/A BKUP 
T58 2/2, and press RETURN. 

6. When BACKUP has completed loading, after approximately five 
minutes, the DCL prompt ($) will appear, and you are ready to 
continue. 



I 7. Leave the second BACKUP TU58 in the drive until you have 
restored the required save set. \ 



2.5.2 Restoring the Required Save Set to the Target Device 

After stand-alone BACKUP has been loaded, the procedure for restoring 
the required save set to the target disk is the same for both magnetic 
tape and disk distribution kits. 

1. Place the target disk in the drive and spin up the disk by 
pressing the RUN button. In the case of the RL02/RA80 
configuration the target device is a nonremovable disk and 
need only be spun up. 

2. At the dollar sign prompt, type the BACKUP command in the 
following form: 

BACKUP/VERIFY ddcu : REQUIRED/SAVE ddcu: 

It is important to type the exact syntax of the command, 
including all colons and spaces. 

For example, when your magnetic tape distribution kit is on 
drive MSAO: and your target disk is DMA1:, you would type: 

$ BACKUP/VERIFY MSAO : REQUIRED/SAVE DMAl.: 

The /VERIFY qualifier specifies that the distribution medium 
and the target disk should be read and compared. Optionally, 
the /LOG qualifier can be used in addition to the /VERIFY 
qualifier, if you want BACKUP to list each file on the 
console terminal as it is restored. 
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You will then receive the following message: 

%BACKUP-I-STARTVERIFY f starting verification pass 

After a few minutes, you will receive the DCL prompt ($) at 
the console terminal. 

3. Halt the processor and terminate stand-alone BACKUP by 
pressing CTRL/P and then typing H. 

4. If you loaded stand-alone BACKUP from TU58 (magnetic tape 
distribution kit) , remove the second BACKUP TU58 from the 
drive and replace it with the console TU58. 



NOTE 

The BACKUP command creates a system disk 
with a DIGITAL-provided set of volume 
parameters, including a cluster factor 
of 1. Most of these parameters, except 
for the cluster factor, can be modified 
after installation with the SET VOLUME 
command. To alter the cluster factor, 
however, you must back up the system 
disk, using the /NOINITIALIZE qualifier, 
to another volume that has been 
initialized with the desired values. 



2.6 BOOTING THE TARGET DEVICE AND RESTORING THE REST OF VMS 

To boot the partially built operating system and restore the rest of 
VAX/VMS, proceed as follows: 

1. At the console terminal, boot the target disk by typing the 
following : 

>>>B ddcu 
For example: 

>>> B DMA1 
The system will respond with the following message: 

VAX/VMS Version V3. 2 <date hh:mm> 

%OPCOM, <date hh:mm:ss.s>, logfile initialized 
by operator OPAO 

logfile is SYS $MANAGER: OPERATOR. LOG 
Login quotas - Interactive limit=64, 
Current interactive value=0 
PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM) 

2. Enter the date and time in the twenty-four hour clock format, 
and press RETURN. 

For example: If it is June 1, 1983, at 2:05 P.M., enter 
01-JUN-1983 14:05. 

3. The system will prompt you as follows: 

Enter drive holding distribution kit (DDCU): 
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Enter the name of the device holding the distribution kit. 
For example: 
MSAO 

The installation procedure uses this information to restore 
the library and optional save sets. 

In the case of the RL02/RA80 configuration, the optional save 
set is distributed on a separate disk and may be installed 
either at installation time (described in Step 5) , or at a 
later date (described in Section 2.6.1). 

4. The following messages will appear over the course of 
approximately 15 minutes, while the files are being restored. 

%MOUNT-I -MOUNTED, VMS032 mounted on <device> 

Restoring library save set. 
%BACKUP-I-STARTVERIFY, starting verification pass 

5. This step applies only to the RL02/RA80 configurations. If 
you are installing any other configuration you should skip to 
Step 6. 

You will receive the following prompt. 

Do you wish to install the OPTIONAL distribution kit 
[No] ? 

Press RETURN if you do not wish to install the optional kit. 
If you do not install the optional kit, the next message you 
will receive is the "Running AUTOGEN" message in Step 6. 
Continue the installation from that point. 

If you respond with the letter Y, you will receive the 
following prompt. 

Dismount the Primary distribution kit from drive DLAO. 

Mount the OPTIONAL distribution kit in drive DLAO, press return when ready. 

Spin down the primary disk and replace it with the optional 
disk. Spin up the optional disk and press RETURN. A 
confirmation of the disk mount will appear: 

MOUNT-I -MOUNTED, VMSOPT mounted on _DLA0: 

6. You will now receive the following messages: 

Restoring optional save set. 
%BACKUP-I-STARTVERIFY, starting verification pass 

Running AUTOGEN — Please wait. 

While AUTOGEN is running, you will receive messages telling 
you which files have been created or extended. When it has 
completed running, you will receive the following message: 

%Opcom, <date hh :mm:ss .s> , message from user SYSTEM 

%SYSGEN-I-WRITECUR, CURRENT system parameters modified by process ID 
00010045 into file SYS$SYSROOT: [SYSEXE ] SYS. EXE ; 1 

System shutting down to allow boot of complete V3. 2 system. 
You must manually reboot the system after it halts. 
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While the system is shutting down, the command procedure 
displays shutdown messages. When the shutdown is complete, 
you receive the following message: 

SYSTEM SHUTDOWN COMPLETE - USE CONSOLE TO HALT SYSTEM 

7. Halt the system, by pressing CTRL/P, typing an "H", and 
pressing RETURN. 

8. Reboot the system by typing: 

>>> B ddcu 

Restoration of the distribution disk is complete; you have a running 
system. Refer to Chapter 3 for any site-specific modifications you 
might want to make to the system. 



2.6.1 Restoring the Optional Kit on an RL02/RA80 Configuration 

Restoration of the save sets on the optional disk to the RL02/RA80 
configuration can be done at a later date by invoking a command 
procedure (VMSINSTAL.COM) that uses the Backup Utility. The two save 
sets contained on the disk are restored separately; you can restore 
one without the other by specifying different parameters for the 
command procedure. 

To restore the optional kit to the system disk, perform the following 
procedure: 

1. Remove any disk currently in the RL02 drive and replace it 
with the optional distribution disk. Write protect the disk 
by pressing the WRITE PROT button and spin up the disk. The 
unit number light will come on when the disk is ready. 

2. Log in as the system manager by performing the following 
steps at the console terminal: 

a. Press RETURN. 

b. In response to the system's request for your user name, 
type SYSTEM. 

c. In response to the system's request for your password, 
type the system manager password. 

The system returns the following message and DCL prompt: 

Welcome to VAX/VMS Version V3. 2 
$ 

3. When the DCL prompt ($) appears on the console terminal, set 
your default directory to SYS$UPDATE by typing: 

$ SET DEFAULT SYS$UPDATE 
The system responds with another DCL prompt. 
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4. Type: 

$ @VMSINSTAL VMSOPT 

This command invokes the VMSINSTAL command procedure, which 
prompts with: 

Enter drive holding distribution kit: 

5. Assuming that the RA80 drive is designated as unit and the 
RL02 drive is designated as unit l f enter DLA1. The system 
responds with: 

%MOUNT-I -MOUNTED, VMSOPT mounted on DLA1 

The command procedure then prompts: 

Enter the device to which the optional save-set should 
be restored (DDCU) : 

6. When you enter DUAO, the system responds: 

Restoring optional files. 

After approximately 5 minutes, the following message appears 
on the terminal: 

%BACKUP-I-STARTVERIFY, starting verification pass 

After approximately 5 minutes more, you will receive the 
completion messages: 

OPTIONAL file set restoration complete. 
Kit installation complete. 

The optional VAX/VMS files are now restored to your system disk. You 
install the EDTCAI course from the optional disk by using the 
parameter EDTCAI in place of VMSOPT (See Chapter 4) . 
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CHAPTER 3 
SITE-SPECIFIC MODIFICATIONS TO VAX/VMS 



The VAX/VMS operating system that exists at this point in the 
installation procedure is already set for your site's hardware 
configuration. During initial bootstrap the AUTOGEN command procedure 
automatically set the system parameters, paging file, swapping file, 
system dump file, and installed images list to values considered 
appropriate for your system. On most systems no further modifications 
to these files should be required. 

Your site-specific start-up command procedure is blank and the 
bootstrap command procedure is a default. The procedures are set to 
these defaults to allow the initial bootstrap of the system and may 
require site-specific modifications. 
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site, you may do either of the following: 

• Modify system parameters for special hardware configuration 
needs or special workload requirements 

• Perform other site-specific modifications 



3.1 LOGGING IN TO THE SYSTEM 

Before you can perform any modifications to the system, you must log 
in as the system manager. Once the system is initialized, it 
announces itself with the following message: 

Login quotas - Interactive limit=64, Current interactive value=0 
SYSTEM Job terminated at <date hh:mm:ss.s> 

At this point, you can log into the system as the system manager by 
performing the following steps at the console terminal: 

1. Press RETURN. 

2. In response to the system's request for your user name, type 
SYSTEM. 

3. In response to the system's request for your password, type 
MANAGER. 

The system displays the following message: 

Welcome to VAX/VMS Version V3.2 

and the Digital Command Language (DCL) issues its prompt ($). When 
this prompt appears on the console terminal, you can begin modifying 
the system. 
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3.2 SITE-SPECIFIC MODIFICATIONS 

There are several site-specific modifications that may be performed 
while you are logged in as system manager. 

When the system is bootstrapped, it uses a default start-up command 
procedure, SYS$SYSTEM :STARTUP. COM . This command procedure, in turn, 
requests the execution of a site-specific start-up command procedure, 
SYS$MANAGER:SYSTARTUP.COM, which is initially blank and should be 
customized for your site. For example, SYSTARTUP.COM could contain 
the commands that initialize and start up your site's batch and print 
queues . 

You may also want to customize the user authorization file and create 
user file directories. 

To perform these site-specific modifications, consult the VAX/VMS 
System Management and Operations Guide. 



3.3 SYSTEM SHUTDOWN AND REBOOT 

In order to ensure that all the modifications you perform are accepted 
by VAX/VMS, you must shut down and then .reboot the system. 

1. Shut down the system by executing the following command 
procedure : 

$ §SYS$SYSTEM: SHUTDOWN 

This command procedure prompts for the number of minutes 
until system shutdown, the reason for the shutdown, whether 
to spin down the disks, the expected time the system will be 
restored, and whether automatic reboot should be enabled. 

If you enabled automatic reboot, the POWER-ON-ACTION switch 
is already set to RESTART/BOOT; the BOOT DEVICE switch is 
already set to your current system disk, and the system 
handles rebooting by itself. You can skip steps 2 and 3. 

2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT SYSTEM," halt the processor by pressing 
CTRL/P to obtain the console prompt (>>>) . 

3. To boot the system, make sure the BOOT DEVICE switch is set 
to boot from your newly built system disk, and type B. 

The system will respond with the message: 

VAX/VMS Version V3.2 <date hh:mm> 

The system is now completely installed. 

For more information on ways to boot the system, see Section 5.2. 
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3.4 MODIFYING SYSTEM PARAMETERS 

The AUTOGEN command procedure is automatically run upon initial 
bootstrap of your system. This procedure generates your VAX/VMS 
system with system parameter values suitable for your hardware. 
Howeyer in cases of unusual hardware configuration or special workload 
requirements, modifications of the system parameters may be necessary. 
The file SYS$SYSTEM :PARAMS. DAT contains the system parameters and can 
be edited to suit your needs. 

If you make changes or additions to the PARAMS.DAT file, when you are 
finished you must invoke the AUTOGEN command procedure with the 
command : 

$ @SYS$UPDATE: AUTOGEN 

Invoking AUTOGEN establishes your changes as the current values. 

For detailed information about system parameters refer to the VAX/VMS 
S ystem Management and Operations Guide. 



3.5 VAX/VMS USER ENVIRONMENT TEST PACKAGE 

The first thing you should do with your newly installed system is run 
the VAX/VMS User Environment Test Package (UETP) . The UETP is a 
collection of tests designed to demonstrate that the hardware and 
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of running the UETP are described in the VAX/VMS UETP User's Guide. 
When the UETP runs to completion without encountering nonrecoverable 
errors, the system is ready for use. 



3.6 BACKING UP YOUR SYSTEM DISK TO A SCRATCH DISK OR TAPE 

To back up your system disk to a scratch disk or tape use stand-alone 
BACKUP TU58 cartridges. The procedure is as follows: 

1. Shut down your system. 

2. Write protect your system disk by pressing the WRITE PROTECT 
button. 

3. Boot stand-alone BACKUP from the TU58 cartridges (see Section 
2.5.1.2) . 

4. Place a scratch volume on an appropriate drive. 

5. Issue one of the following BACKUP commands: 

For disk: BACKUP/VERIFY system-disk: scratch-disk: 

For tape: BACKUP/VERIFY system-disk: tape device :save-set name 

For example, where the system disk is DMAO and the scratch 
disk is DMA1: 

$ BACKUP/VERIFY DMAO: DMA1 : 

For more details on using BACKUP, see the BACKUP chapter of the VAX- 11 
Utilities Reference Manual . 

If you received an RK07 or RA60 distribution kit, see Section 5.4 to 
build stand-alone BACKUP on TU58 cartridges. 
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3.7 THE SYSTEM AFTER INSTALLATION 

Now that your system is installed, and any needed site-specific 
modifications have been made, there are several procedures you may 
want to perform on the system. You can back up the console medium, 
perform several methods of boostrapping , build and copy a VAX/VMS 
system disk, or build a stand-alone BACKUP kit. See Chapter 5 for 
instructions on these procedures. 
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CHAPTER 4 

t" 

THE VMSINSTAL COMMAND PROCEDURE 



The command procedure VMSINSTAL is used to install system maintenance 
updates and optional software products. 

Eventually, all optional software products will be installed using 
VMSINSTAL. However, at the present time, VMSINSTAL is used to install 
only some optional software products. DIGITAL is in the process of 
converting the remaining optional software product installations to 
the use of VMSINSTAL. Until they have been converted, these optional 
software products will continue to be installed using the VMSUPDATE 
command procedure (see Appendix E) . 



This chapter describes what to look for in the so 
distribution kits, how to prepare for installation 
VMSINSTAL. how to choose among installation procedure 
what to do in the event of a system failure during inst 
chapter does not describe the specific installation 
each update and product. The questions, prompts, and i 
you receive during installation will differ from produc 
For specific installation details, consult the installa 
comes with each update or product. This chapter 
installation of EDTCAI, a software product that is inc 
VAX/VMS distribution kits. 



ftware product 
, how to invoke 
options. and 
allation. This 
procedures for 
nformation that 
t to product, 
tion guide that 
also describes 
luded with some 



For information explaining the error messages 
VMSINSTAL command procedure, see Appendix H. 



received from the 



4.1 EXAMINING THE DISTRIBUTION KITS 

System updates and optional software products are distributed on TU58 
cartridges or magnetic tape. EDTCAI is a save set on the VAX/VMS 
distribution kit, which can be either disk or magnetic tape. 

Each cartridge, disk, or tape is labeled with both a name and a serial 

number that differentiates it from others in the distribution kit. 

Check that your kit contains everything listed in the bill of 
materials . 

Included in each distribution kit is the installation guide specific 
to that update or product. 



4.2 PREPARING TO USE VMSINSTAL 

In order for VMSINSTAL to run properly, you must first do the 
following : 
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1. Back up your system disk (see Section 3.6). A system failure 
at a critical point of the installation could leave unusable 
files. In addition, optional software products may delete 
older product versions before installing new ones, so it is 
advisable to back up your system disk before attempting any 
software installation. The backup copy you create should be 
used for the installation to verify that the backup copy 
contains a working system and because, of the two, it has 
more free contiguous space, which you may need for 
installation. 

2. Log in at the console terminal under the system manager's 
account, SYSTEM. 

(If the SYSGEN parameters MOUNTMSG or DISMOUMSG at your site 
have been set to 1, you will receive a message from OPCOM 
each time a disk or tape is mounted or dismounted. These 
messages are normally disabled, but if they have been 
activated and you are installing from an operator's terminal, 
they will appear from one to thirty seconds after each mount 
or dismount.) 

3. Ensure that all users are logged out and that all batch jobs 
are completed. 

4. Prevent users from gaining access to the system by entering 
at the DCL prompt ($): 

$ SET LOGINS/INTERACTIVE=0 

5. Shut down DECnet-VAX (if your system includes it) by 
entering : 

$ RUN SYS$SYSTEM:NCP 

The system responds with the NCP prompt (NCP>). At the 
prompt, enter: 

NCP> SET EXECUTOR STATE SHUT 

DECnet-VAX will perform an orderly shutdown and the OPCOM 
facility will notify you when DECnet-VAX is off. Exit from 
the NCP by typing EXIT at the prompt. 

6. Ensure that the limits in the SYSTEM account authorization 
record have values that are equal to or greater than the 
following designated default values: 

Buffered I/O byte count quota (BYTLM) = 20480 

Enqueue quota (ENQLM) = 20 

Buffered I/O limit (BIOLM) = 12 

Direct I/O limit (DIOLM) = 12 

Open file quota (FILLM) = 20 

AST limit (ASTLM) = 20 

To check these values, enter the following command at the DCL 
prompt : 

$ SHOW PROCESS/ QUOTA 

The system will display the current values of the SYSTEM 
account's authorization record. 

If necessary, you can change these values by entering at the 
DCL prompt: 
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$ SET DEFAULT SYS$SYSTEM 
$ RUN AUTHORIZE 

The system responds with the UAF prompt (UAF>) . At the 
prompt, enter: 

MODIFY SYSTEM/1 imi t=new-value 

For example: 

UAF> MODIFY SYSTEM/DI0LM=1 2 

To return to DCL command level, type EXIT at the UAF prompt. 
You must log out and log in again for any changes to take 
effect. 



NOTE 

Beyond this point in the installation 
procedures, installations vary according 
to update or product. The following 
section is a general description of how 
to invoke VMSINSTAL. Consult the 

specific update or product installation 
guide before invoking VMSINSTAL. 



4.3 INVOKING VMSINSTAL 

This section is a general description of how to invoke the VMSINSTAL 
command procedure. Section 4.4 describes options that may be used 
when invoking this procedure. 

To initiate installation using VMSINSTAL, enter the following command 
at the DCL prompt: 

@SYS$UPDATE:VMSINSTAL product-list ddcu: 

product-list 

A list of the product(s) being installed from the distribution 
volume. Items in a product list are separated by commas with no 
spaces and are of the format: 

f acvvu 

In this format: 

fac is the facility name (1-6 alphanumeric characters). 

vv is the major version number (2 digits) . 

u is the update number (1 digit) . 

For example, the VAX/VMS operating system, version 3, update 
number 2 is: 

VMS032 

Items in this format allow you to install a specific version and 
update of a product from a distribution volume containing several 
versions and updates. If you specify only the facility name, 
with no version or update number, then all versions and updates 
present on the volume are installed in chronological order. You 
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may specify a wildcard character (*) for the product list, in 
which case all versions and updates of all products present on 
the volume are installed in chronological order. At the present 
time, DIGITAL generally distributes only a single version of a 
product per distribution volume. 

You will be prompted for a product list if you omit this 
parameter . 



ddcu 



The device specification of the drive on which the distribution 
volume for the optional software product or maintenance update is 
to be mounted. You will be prompted for this parameter if you 
omit it. 

At this point, if the conditions described in Section 4.2 are not met, 
you will receive a warning that explains the problem and a prompt 
asking if you wish to continue. It is strongly recommended that you 
correct the situation before reinvoking VMSINSTAL. If you continue, 
the resulting installation may not be supported by DIGITAL. 

You will also be asked if you are satisfied with the backup of your 
system disk (see Section 4.2). Again, if you are not satisfied, it is 
strongly recommended that you correct the situation before continuing. 

Once you invoke VMSINSTAL you will receive several prompts and 
messages that direct and explain the installation. These prompts and 
messages differ depending on the update or software product. Consult 
the installation documentation that comes with the update or software 
product for specific instructions. If you need assistance during an 
installation, typing a question mark (?) at a prompt will give you an 
explanation of the acceptable responses to that prompt. 

At the end of an installation, VMSINSTAL will do one of two things, 
depending on the requirements of the update or product. It will 
either perform an automatic shutdown of the system and instruct you to 
manually reboot, or it will simply return you to the DCL command 
level . 

Finally, after installing the update or optional software product(s), 
you should back up the updated system disk. 



4.4 CHOOSING VMSINSTAL OPTIONS 

The VMSINSTAL command procedure permits the use of three options; 
Auto-answer, File Log, and Alternate Root. These options perform the 
following functions: 

Auto-answer 

Allows you to record the answers you give to queries and prompts 
during installation. When you install an update or product, you 
receive several prompts and queries to which you respond. When 
you use the Auto-answer option VMSINSTAL creates a file with the 
specification SYS$UPDATE:f acvvu. ANS (if such a file does not 
already exist) and saves your responses in this file. If you 
reinstall a software product in the future (as you must when a 
major version of the VAX/VMS operating system is distributed) and 
you use the Auto-answer option, VMSINSTAL will check for the 
existence of facvvu.ANS and use the answers you have saved. If 
you reinstall without using the Auto-answer option, you will 
again receive prompts and queries during installation. 
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Note that if you wish to record new answers in a subsequent 
installation, you must first delete the existing answer file and 
then install the product again, specifying the Auto-answer 
option. 

File Log 

Logs all file activity to the terminal during installation, File 
activity is defined as any action that alters the disposition of 
a file, such as, creating a new file, updating a library, or 
deleting a file. 

Alternate Root 

Permits you to install to a system root other than that of the 
running system. The VAX/VMS system in the alternate root must be 
complete and at the same version/update level as the running 
system. All files and software products that are referenced by 
the product installation must be present in the alternate root. 

Note that not all optional software products allow installation to a 
system root other than that of the running system. Consult the 
specific product's installation documentation to determine whether it 
is possible. 

The format for invoking VMSINSTAL with these options is as follows: 

@SYS$UPDATE: VMSINSTAL product-list ddcu: OPTIONS option-list [root] 

OPTIONS 

A keyword that must be entered along with one or more options in 
the option list to guarantee against accidentally invoking an 
option. If you enter an option-list and the OPTIONS parameter is 
not entered, you will receive an error message and the 
installation will be terminated. 

option-list 

A list of the options requested. This list consists of one 
letter option abbreviations separated by commas, with no spaces. 
The abbreviations are: A for Auto-answer, L for File Log, and R 
for Alternate Root. You may specify any option or all three. 
However, if you specify Alternate Root, you must also specify the 
root parameter (see below) . 

root 

The alternate system root to which you wish to install the 
product(s) . It must be of the format: 

ddcu: [SYSn.] 

(Note that two leading underscores are required.) 

In this format: 

ddcu is the device on which the alternate root resides 

[SYSn.] is the top level directory of the alternate root 

You may specify a logical name that has been defined for an alternate 
root . 
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The following is an example, of using VMSINSTAL with options: 

$ @SYS$UPDATE: VMSINSTAL VMS032 CSA1: OPTIONS L,R DMA1:[SYS0.] 

In this example, update version 3.2 of the VAX/VMS operating system is 
being installed to the alternate root, [SYSO.], on the device, DMA1 . 
The file activity during installation is being logged to the terminal, 
as we 1 1 . 



4.5 RECOVERING FROM SYSTEM FAILURE 

If you experience a system failure, such as power loss, during 
installation of an update or optional software product, VMSINSTAL will 
attempt to automatically continue the installation upon rebooting. If 
you are booting from the console TU58, you will have to place the 
console TU58 back in the console TU58 drive in order to reboot. 
Depending on the point in the installation at which the system failed, 
one of three conditions will exist: 

1. The system disk will not have undergone any changes before 
system failure. In this case, VMSINSTAL will instruct you to 
restart the installation. 

2. The system disk or a library used by the installation will 
have been corrupted. In this case, VMSINSTAL instructs you 
to restore either the system disk, or the corrupted library 
from the backup copy (see Section 4.2), and restart the 
installation . 

3. VMSINSTAL will continue the installation. In this case, 
VMSINSTAL performs most of the installation and then informs 
you that you must manually purge replaced files, even if you 
requested that they be purged automatically. If VMSINSTAL 
instructs you to do so, reboot the system, log in as system 
manager, and purge all system files by entering at the DCL 
prompt ( $ ) : 

$ PURGE/LOG SYS$SYSROOT: [*...] *.* 

When you have performed these tasks, installation is 
complete . 



4.6 INSTALLING EDTCAI 

The installation of EDTCAI uses neither VMSINSTAL as it is described 
above nor VMSUPDATE. It uses a version of VMSINSTAL without options 
that does not attempt to recover from a system failure. To install 
the EDTCAI course, perform all the steps described in Section 4.2, 
then proceed as follows: 

1. Mount your distribution disk or tape. 

2. Type the following command to initiate the installation of 
EDTCAI: 

$ @SYS$UPDATE:VMSINSTAL EDTCAI 

3. You will receive the following request: 

Enter drive holding distribution kit: 
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You must type your response in the format ddcu: dd is the 
device code; c, the controller letter, and u, the unit 
number . 

You will then see the following message text at the terminal: 

This procedure will install the EDTCAI course on your system. 
This course will work on either the VT52 or a VT100 compatible 
terminal. However, the display library for each terminal type 
is over 500 blocks, and if you do not have a particular terminal 
type on your system, you might wish to save disk space by not 
installing that particular library. 

You will receive the following query: 

Do you wish to install the display library for VT52 terminals?: 
Respond YES or NO. 
You will then receive the next question: 

Do you wish to install the display library for VT100 terminals?: 

Answer YES or NO. You must install at least one of the two library 
files for the EDTCAI course to run on your system. 

After answering YES to at least one of the two preceding questions, 
you receive this message: 

Added course EDT, the EDTCAI Primer 

If you have upgraded from a previous version of EDTCAI, at this point 
you will be asked: 

Do you wish to copy student records from EDTCAI VI to this 
version? : 

Answer YES or NO. If you answer YES, the names of the students will 
be displayed as they are copied. When all the names have been copied, 
the following will be displayed: 

Now that the student records are copied, you may delete the old 
records to save disk space. 

Do you wish to delete the old student records (Y or N) : 
Answer YES or NO. If you answer YES, the following will be displayed: 

The old student records have been deleted. 
If you answer NO, the following will be displayed: 

The old student records have not been deleted. 

When the installation of the EDTCAI course is completed, you will 
receive this message: 

Kit installation complete. 
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THE SYSTEM AFTER INSTALLATION 



You will want to perform several operations after your system is 
installed : 

• Backing up the console TU58 cartridge 

• Performing several methods of bootstrapping 

• Building and copying a system disk. 

• Building a stand-alone BACKUP kit. 

C 1 D A /-»T7 TXT/"" TTT> TlTTl? nnilPnr T3 MOnTTlU 

It is important that you have a backup copy of the console medium. To 
back up the console medium, use the command procedure CONSCOPY 
contained in the SYS$UPDATE directory. CONSCOPY copies files from the 
TU58 cartridge to an empty scratch directory on a disk. From the 
scratch directory, the files can be restored to another TU58 
cartridge. (The blank TU58 cartridge included in your distribution 
kit may be used for this purpose if it was not used during the upgrade 
procedure.) To use CONSCOPY, proceed as follows: 

1. Log in under the system manager's account, SYSTEM. 

2. Create a scratch directory if one is not already available. 
If a directory already exists, make sure it contains no 
files. To create a directory, type: 

CREATE/DIRECTORY ddcu : [d i rectory name] 

For example: 

$ CREATE/DIRECTORY DMA1: [WRK.CNSL] 

3. At the DCL prompt ($), enter the following: 

$ @SYS$UPDATE: CONSCOPY 

4. You will receive the following question: 

Which kit do you want to build (780! 750 !730) : 
Answer by typing 750. 
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5. A brief description of the SAVE and RESTORE operations will 
appear . 

You will then be asked whether you want to SAVE or RESTORE 
your console medium. 

Answer by typing SAVE. 

6. The following will then appear: 

Enter Files-11 device and directory (DDCU: [DIR] ) : 

Type in the device code for the disk to be copied to and 
specify the empty directory to contain the files. 

For example: 

DMA1: [WRK.CNSL] 

7. At this point, you will receive the following prompt: 

Enter the console device drive (DDCU:): 
Answer by typing CSA1:. 

8. Put your console TU58 into the drive on the processor control 
panel and press RETURN when ready. 

9. When the files have been copied from the TU58 to the disk, 
you will receive this message: 

SAVE of your console medium is complete. 

5.1.1 Restoring Files to TU58 Cartridge 

To restore files to another TU58 cartridge, proceed as follows: 

1. Invoke CONSCOPY by typing: 

$ @SYS$UPDATE: CONSCOPY 

2. You will receive the following question: 

Which kit do you want to build (780 !750 ! 730) : 
Answer by typing 750. 

3. A brief description of the SAVE and RESTORE operations will 
appear . 

You will then be asked whether you want to SAVE or RESTORE 
your console medium. 

Answer by typing RESTORE. 

4. The following will then appear: 

Enter Files-11 device and directory (DDCU: [DIR] ) : 

Type in the device code for the disk and specify the 
directory that contains the files. 
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5. At this point, you will receive the following prompt: 

Enter the console device drive (DDCU:): 
Answer by typing CSA1:. 

6. Put the scratch TU58 into drive CSA1 and press RETURN when 
ready. 

7. When the files have been restored from the disk to the TU58, 
you will receive this message: 

RESTORE of your console medium is complete. 

This newly created TU58 will be your console TU58. Keep the original 
as a backup copy. Press RETURN to mount this new TU58. 



5.1.2 Reading Command Procedures From Console Media 

To read bootstrap command procedures from the console TU58, you must 
first copy the files from the console TU58, using the DXCOPY command 
procedure in the directory [SYSUPD] . To use DXC0PY.COM for this 
purpose, proceed as follows: 

1. Invoke the command procedure by typing: 



2. The command procedure asks whether the console TU58 is 
mounted: 

Is the system console storage medium mounted (Y/N)?: 

Place the console TU58 in the CSA1 drive, type NO, and press 
RETURN, as prompted. 

3. The command procedure then asks whether the copy operation is 
from the console TU58: 

Copy from console medium (Y/N)?: 

Type YES to indicate a copy from the console TU58 to the 
default directory. 

4. Finally, the command procedure requests the name of the file 
to be copied from the console TU58. Type the name of the 
file and press RETURN. 

You can now read the file from the default directory. 



5.2 BOOTING THE SYSTEM AFTER INSTALLATION 

During installation, a default bootstrap is used for simplicity's 
sake. However, once the system has been installed, you can bootstrap 
the system in either of the following ways: 

• Conversational - Request that SYSBOOT stop and allow you to 
modify the system parameters that configure the system. 
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• Nonstop - Allow SYSBOOT to run to completion without your 
intervention . 

Whether you perform a conversational bootstrap or a nonstop bootstrap, 
the following options are available to you: 

• Bootstrap the system directly from the system disk 

• Bootstrap the system using the stand-alone BOOT58 program on 
the console TU58 cartridge 



5.2.1 Rebooting Stopping in SYSBOOT 

The system bootstrap program, SYSBOOT.EXE, is the secondary bootstrap 
program that loads and configures the system. Because you can request 
that SYSBOOT prompt for commands during the bootstrap operation, this 
procedure is known as a conversational bootstrap operation. Using 
this procedure, you can do the following: 

• Designate the name of the file that contains system parameter 
values 

• Set and show individual parameter values 

• Specify an alternate site-independent start-up procedure 
To halt the processor and reboot stopping in SYSBOOT: 

1. Shut down the system by executing the following command 
procedure : 

$ @SYS$SYSTEM:SHUTDOWN 

This command procedure prompts for the number of minutes 
until system shutdown, the reason for the shutdown, whether 
to spin down the disks, the expected time when the system 
will be restored, and whether automatic reboot should be 
enabled . 

2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT SYSTEM," halt the processor and obtain the 
console prompt (>>>) by pressing CTRL/P. 

3. Bootstrap the system, using the following command: 

>>> B/l ddcu 

(dd is the device type, c is the controller designator, and u 
is the unit number.) 

4. When SYSBOOT is ready to accept commands, it prompts as 
follows : 

%% 
SYSBOOT> 

The two percent signs (%%) that precede the SYSBOOT prompt 
indicate a successful micro verify check. If the percent 
signs do not appear, discontinue the bootstrap operation and 
contact your field service representative. 

When SYSBOOT prompts, you may use any of the subset of SYSGEN 
commands listed in Table 5-1 to examine or modify the system. 
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The following is an example of the SYSBOOT program: 

SYSBOOT> USE CURRENT 

SYSBOOT> SET WSMAX 512 

SYSBOOT> CONTINUE 

In this example, the program is told to use the current parameter file 
as a source for values, WSMAX is set to 512, and the bootstrap 
operation is continued. When VAX/VMS announces itself, the new 
parameter value you have designated is in use. More information about 
these SYSGEN commands can be found in the VAX- 11 Utilities Reference 
Manual . 

Table 5-1: SYSBOOT Commands 



Command 



Description 



CONTINUE 
DISABLE CHECKS 

ENABLE CHECKS 



Resumes the bootstrap procedure 

Inhibits checking of parameter values 
specified with the SET command 

Permits checking of parameter values 



HELP 

SET parameter value 

SET/STARTUP procedure 

SHOW 
USE 



Displays a summary of the SYSBOOT commands 
at your terminal 

Establishes the value of a system 
generation parameter 

Specifies the start-up command procedure 
to be executed after SYSBOOT 

Displays specific parameters 

Specifies the parameter file to be used as 
a source of values (if a parameter file is 
specified, you must specify the entire 
file specification) 



5.2.2 Nonstop Bootstrap from the System Disk 

To perform a bootstrap operation from the system disk, without 
stopping in SYSBOOT, proceed as follows: 

1. Shut down the system by executing the following command 
procedure : 

$ @SYS$SYSTEM: SHUTDOWN 

2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT SYSTEM," halt the processor by pressing 
CTRL/P to obtain the console prompt (>>>) , and type the HALT 
command . 



5-5 



THE SYSTEM AFTER INSTALLATION 



3. Type the console BOOT command in the following command 
format : 

>>> B ddcu 

(dd is the device type, c is the controller designator, and u 
is the unit number.) 



5.2.3 Rebooting Using the Default Bootstrap 

Under normal system operation, you do not need to interrupt the 

bootstrapping of the system to type commands to SYSBOOT; parameter 

values have already been established. To reboot using the default 
bootstrap, proceed as follows: 

1. Shut down the system by executing the following command 
procedure : 

$ @SYS$SYSTEM: SHUTDOWN 

2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT SYSTEM," halt the processor by pressing 
CTRL/P to obtain the console prompt (>>>) , and type the HALT 
command . 

3. Either type BOOT or press the BOOT push button on the 
processor control panel. The processor will attempt to boot 
from the device selected by the Boot Device Switch on the 
front panel . 

Appendix B contains a description of bootstrapping from the console 
TU58. 



5.3 BUILDING AND COPYING A VAX/VMS SYSTEM DISK 

Occasionally, you may want to build or make a copy of your system 
software. VAX/VMS provides a command procedure named VMSKITBLD.COM as 
part of the system software for the purposes of building and copying a 
VAX/VMS operating system. 



NOTE 

Do not press CTRL/C or CTRL/Y while 
running VMSKITBLD.COM unless you want 
the command procedure to terminate. 



5.3.1 Building a VAX/VMS System Disk 

You can use VMSKITBLD.COM to build a VAX/VMS system binary disk. For 
example, if you have a mixed-disk system (with RK07 and either RP06, 
RP07, RM03, RM05, RA60, RA80, or RA81 disks, but no magnetic tape 
drives) , you can use VMSKITBLD.COM to transfer your VAX/VMS system 
from an RK07 disk cartridge to a larger, faster RP06, RP07, RM03, 
RM0 5, RA60, RA80, or RA81 disk. 

Before you can use VMSKITBLD.COM to build a VAX/VMS system (on an 
RP06, for example) you must boot your system, as described at the 
beginning of this chapter. With this RK07 system running, proceed as 
follows : 
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1. Log in under the system manager's account. 

2. Establish the following default directory: 

$ SET DEFAULT SYS$UPDATE 

3. Place either an RP06, RP07, RM03, RM05, RA60, RA80, or RA81 
disk on an appropriate drive and place it online. This will 
be the target disk in the system building procedure. 

4. Type the following command to initiate the building of the 
system : 

$ @VMSKITBLD 

5. Supply the needed information about the source and target 
disks as prompted. 

You then receive the following query: 

Is this a BUILD, ADD, or COPY operation?: 

Answer by typing BUILD. 

NOTE 

The BUILD option destroys all previous 
l n J.O rrna t ion on tue target uiSK uciore k 
builds the system. 

Continuation of the system disk-building procedure is indicated by the 
display of messages at your terminal. These messages either (1) 
prompt you for information needed to complete the copy operation, or 
(2) inform you of the current status of the building procedure. Each 
response should be followed by pressing the RETURN key. 

For example: 

Enter mounted source disk name (DDCU:): SYS$SYSDEVICE: 

Enter SOURCE disk top level system directory [default = SYSO] : 

Enter target disk name (DDCU:): DRAO: 

Enter the target disk's label [default = VAXVMSRL3] : 

Enter TARGET disk top level system directory [default = SYSO]: 

It will be necessary to initialize the target disks(s). 
Is the target disk, DRAO:, ready to be initialized? (Y/N) : Y 

_DRA0: allocated 
%MOUNT-I-MOUNTED, VAXVMSRL3 mounted on _DRA0 : 
Create directory entries on the target disk. 
Copy the system executive files. 
Copy the system library files. 
Copy the system message files. 
Copy the system manager files. 
Copy the system update command files. 
Copy the system EXE files. 
Copy the system help files. 
Write a bootblock. 
Copy BLISS require files. 
Copy coding examples. 
Copy the EDTCAI files. 
Copy the UETP files. 
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VMSKITBLD.COM informs you when the system disk is built by sending the 
following message to your terminal: 

Kit is complete. 

At this point, the disk contains all the required VAX/VMS files for a 
complete system. The system can be properly configured by 
bootstrapping using the default parameters and then using the AUTOGEN 
procedure to configure the target system. 

To boot the system with the default parameters invoke the GEN version 
of the boot command file by typing: 

>>> B/l ddcu 
When you have the SYSBOOT prompt (SYSB00T>) type the following: 

SYSB00T> USE DEFAULT 
SYSB00T> CONTINUE 

The system will boot at this point. You can then log in as system 
manager and run the AUTOGEN procedure described in Chapter 12 of the 
VAX/VMS System Management and Operations Guide. 



5.3.2 Copying a VAX/VMS System Disk 

You can also use VMSKITBLD.COM to copy the files of the VAX/VMS system 

disk to a target disk that already contains a valid VAX/VMS system. 

The copy operation modifies only system files; it leaves all user 
files intact. 

Before you can use VMSKITBLD.COM to copy one system disk to another, 
your VAX/VMS system must be running and the source disk that you 
intend to copy must be mounted. Often, this source disk is the system 
disk from which the system was booted. Proceed as follows to copy the 
source disk to a target disk: 

1. Log in under the system manager's account (initially, the 
account with the user name SYSTEM and the password MANAGER) . 

2. Establish the following default directory: 

$ SET DEFAULT SYS$UPDATE 

3. Place the target disk on an appropriate drive. 

4. Type the following command to initiate the copy operation: 

$ @VMSKITBLD 

5. Supply the information needed about the source and target 
disks as prompted. 

You then receive the following query: 

Is this a BUILD, ADD, or COPY operation? 

Answer by typing COPY. 

Continuation of the copy operation is indicated by the display of 
messages at your terminal. These messages either (1) prompt you for 
information needed to complete the copy operation, or (2) inform you 
of the current status of the copy operation (see the example in 
Section 5.3.1) . 
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VMSKITBLD.COM informs you when the copy operation is complete by 
sending the following message to your terminal: 

Kit is complete. 
At this point, the disk is ready to be bootstrapped. 



5.4 BUILDING A STAND-ALONE BACKUP KIT 

If you received your distribution kit on RK07 or RA60 disk, the 
stand-alone Backup Utility is contained on that disk. In order to 
have a kit for stand-alone operations, you must copy stand-alone 
BACKUP from the disk to TU58 cartridges. To create a stand-alone 
BACKUP kit, proceed as follows: 

1. Log in under the system manager's account, SYSTEM. 

2. At the DCL prompt ($), enter the following: 

@SYS$UPDATE : STABACKIT 

3. You will receive this request: 

Specify target device (DDCU:): 
Respond by typing the device name of the console drive: 
CSA1: 

4. The following message will appear: 

Please place the first TU58 in drive CSA1:. 
Press return when ready to continue: 

5. After you have placed the TU58 in the drive and pressed 
RETURN, you will receive these messages: 

%M0UNT-I-M0UNTED, STABACKUPA mounted on CSA1: 
%CREATE-I-CREATED, CSA1 : [SYSEXE] created 

If you are working at a console terminal, or if your terminal 
is enabled as an operator's terminal, you will also receive 
the following messages: 

%0PC0M, (DD-MMM-YYYY HH:MM:SS) , message from user SYSTEM 
%SYSGEN-I-WRITECUR, CURRENT system parameters 
modified by process ID <ID number) into 
file SYS$SYSR00T: [SYSUPD] SYS . EXE ; 1 

These messages will be followed with a list of the files 
copied. When you have received the complete list of the 
files copied, the following message will appear: 

Please place the second TU58 in drive CSA1:. 
Press return when ready to continue: 

6. After you have placed the second TU58 in the drive and 
pressed RETURN, you will receive these messages: 

%M0UNT-I-M0UNTED, STABACKUPB mounted on CSA1: 
%CREATE-I-CREATED, CSA1 : [SYSEXE] created 
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They will be followed with a list of the files copied. Then 
you will receive the following message: 

Kit is complete. 

Please replace the console medium. 

Press return when ready to continue. 

Replace the console TU58 and press RETURN. 

At this point, you have completed building a stand-alone 
BACKUP kit. 
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This appendix contains the names and brief descriptions of the files 
provided by DIGITAL on the VAX/VMS system distribution medium. The 
files on this medium are cataloged in ten directories. The names of 
the directories and descriptions of their contents follow. 

1. [SYSCBI] 

This directory is reserved for EDTCAI files. 

2. [SYSERR] 

This directory is reserved for the error log file 
(ERRLOG.SYS) . 

3. [SYSEXE] 

As shown in Table A-l , this directory contains commonly used 
executable images of the VAX/VMS operating system. 

4. [SYSHLP] 

As shown in Table A-2, this directory contains text libraries 
for the HELP utility and other components. 

Table A-8 lists the contents of the subdirectory, 
[SYSHLP. EXAMPLES] . This subdirectory contains sample driver 
programs, user-written system service programs, and other 
source code examples of interest. 

5. [SYSLIB] 

As shown in Table A-3, this directory contains various macro 
and object libraries as well as other files used for general 
reference. 

6. [SYSMAINT] 

This directory is reserved for system hardware diagnostic 
programs. 

7. [SYSMGR] 

As shown in Table A-4, this directory contains files used in 
managing the operating system. This directory is the default 
directory for the system manager's account. 

8. [SYSMSG] 

As shown in Table A-5, this directory contains system message 
text files. 
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9. [SYSTEST] 



As shown in Table A-6, this directory contains files used to 
run the User Environment Test Package (UETP) . 



10. [SYSUPD] 



As shown in Table A-7, this directory contains files used in 
applying system updates. 



Table A-l: Files Contained in Directory [SYSEXE] 



File Name 



ACC. EXE 

ANALYZOBJ.EXE 

ANALYZRMS.EXE 

AUTHORIZE.EXE 

AUTOGEN.PAR 

BACKTRANS.EXE 

BACKUP.EXE 

BAD. EXE 

BADBLOCK.EXE 

BCK.EXE 

BOOT58.EXE 

BOOTBLOCK.EXE 

CANCEL.EXE 

CHECKSUM.EXE 

CHKSUM.CLD 

CLEDITOR.EXE 

CNDRIVER.EXE 

CNV.EXE 

CNVACC.EXE 

CONFIG.DAT 

CONINTERR.EXE 

CONVERT.EXE 

COPY. EXE 

CRDRIVER.EXE 

CREATE.EXE 

CREATEFDL.EXE 

CRF.EXE 

DBDRIVER.EXE 

DC L. EXE 

DCLDEF.STB 

DDDRIVER.EXE 

DEF.EXE 

DELETE.EXE 

DFN.EXE 

DIFF.EXE 

DIRECTORY.EXE 

DISKQUOTA.EXE 

DISMOUNT.EXE 

DLDRIVER.EXE 

DMDRIVER.EXE 

DM P. EXE 

DQDRIVER.EXE 

DRDRIVER.EXE 

DSC 1. EXE 



Description 



Accounting Utility 

ANALYZE/IMAGE and ANALYZE/OBJECT image 
ANALYZE/RMS_FILE image 
User authorization program 

Parameter file for the Autogen command procedure 
Back translator of DCL into MCR commands 
Backup Utility 
Bad Block Locator Utility 

Dynamic bad block Files-11 ACP subprocess 
RMS-11 backup utility 
Reserved for future use 
Reserved for future use 
CANCEL command 

Used during installation of VAX/VMS updates 
Used during installation of VAX/VMS updates 
Command Definition Utility 
DECnet CI datalink driver 
RMS-11 file conversion utility 
Convert V3.0 account file to V2. format 
Data file for configuration 
Connect-to-Interrupt driver 
Convert Utility 
File copy utility 
Card reader driver 

File and directory creation utility 
CREATE/FDL image 

Compatibility mode cross-reference utility 
RP05 and RP06 disk driver 
Command interpreter 

Global definitions for DCL structures 
TU58 driver 

RMS-11 interactive file definition utility 
File deletion/purge utility 

RMS-11 noninteractive file definition utility 
File compare utility 
Directory utility 
Disk Quota Utility 
Volume dismount utility 
RL02 disk driver 
RK07 disk driver 
RSX-11 File dump utility 
RB730 driver 
RM03 disk driver 
Files-11 Structure Level 
compress utility 



1 disk save and 
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Table A-l (Cont.): Files Contained in Directory [SYSEXE] 



File Name 



Description 



DSC2.EXE 

DSP. EXE 

DTR.COM 

DTRECV.EXE 

DTSEND.EXE 

DUDRIVER.EXE 

DUMP. EXE 

DXDRIVER.EXE 

DYDRIVER.EXE 

DZDRIVER.EXE 

EDF . EXE 

EDI. EXE 

EDT.EXE 

ERRFMT.EXE 

EVL.EXE 

EVL.COM 

F11AACP.EXE 

F11BACP.EXE 

FAL.COM 

DH T X?VTT> 

FLX.EXE 

HEXZAP.EXE 1 

HLD.COM 

HLD.EXE 

IFL.EXE 

IMGDEF.STB 

INILOA.EXE 

INIT.EXE 

INPSMB.EXE 

INSTALL.EXE 

JBCSYSQUE.EXE 

JOBCTL.EXE 

LADRIVER.EXE 

LALOAD.EXE 

LALOADER.EXE 

LBR.EXE 

LCDRIVER.EXE 

LIBRARIAN.EXE 

LINK. EXE 

L0GIN0UT.EXE 

LPDRIVER.EXE 

MAC. EXE 

MACR032.EXE 

MAIL. EXE 

MAIL.COM 

MAILEDIT.COM 

MBXDRIVER.EXE 

MCR.EXE 



Files-11 Structure Level 2 disk save and 

compress utility 
RMS-11 file attribute display utility 
DTRECV.EXE server initiating procedure 
DTSEND server 

DECnet logical links test program 
UDA disk driver 
DUMP utility 

RX01 console floppy diskette driver 
RX02 floppy diskette driver 
DZ11 port driver 
File definition language editor 
RSX-11M text editor 
EDT text editor 
Error logging facility 
DECnet event logging program 
Command file used by DECnet error logging 
Files-11 Structure Level 1 ancillary 

control process 
Files-11 Structure Level 2 ancillary 

control process 
FAL start-up procedure 

File Transfer Utility 
Hexadecimal image patching utility 
Command procedure used by HLD.EXE 
Down line task loading program 
RMS-11 utility index load program 
Global definitions for image activator 

structures 
System initialization program 
Disk device initialization utility 
Card reader input symbiont 
Utility that installs known images 
Queuing facility 
Job controller/symbiont manager 
LPA-11 driver 
Accepts commands from or sends requests to 

LALOADER to load LPA-11 microcode 
Loads LPA-11 microcode upon power recovery 

or upon request from LALOAD 
RSX-11M librarian 
DMF-32 lineprinter driver 
Librarian Utility 
Linker 

Login/logout utility 
Line printer driver 
MACRO-11 assembler 
VAX-11 MACRO assembler 
Mail Utility 

Command procedure used by DECnet mail 
Default MAIL editing command procedure 
Shared memory mailbox driver 
MCR command interpreter 



1. Not supported by DIGITAL. 
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Table A-l (Cont.): Files Contained in Directory [SYSEXE] 



File Name 



Description 



MERGE.EXE 

MESSAGE.EXE 

MIRR0R.COM 

MIRROR.EXE 

MONITOR. EXE 

MP. EXE 

MP. STB 

MTAAACP.EXE 

NCP.EXE 

NETACP. EXE 

NETDEF.STB 

NETDRIVER.EXE 

NML.COM 

NML.EXE 

NOTICE.TXT 

OPCCRASH.EXE 

OPCOM.EXE 

PADRIVER.EXE 

PAGEFILE.SYS 

PARAMS.DAT 

PAT. EXE 

PATCH.EXE 

PH0NE.COM 

PHONE.EXE 

PIP. EXE 

PRTSMB.EXE 

PUDRIVER.EXE 

QUEMAN.EXE 

RECLAIM.EXE 

REMACP.EXE 

RENAME.EXE 

REPLY.EXE 

REQUEST.EXE 

RMS. EXE 

RMSDEF.STB 

RMSSHARE.EXE 

RST.EXE 

RSX.EXE 

RTB. EXE 

RTPAD.EXE 

RTTDRIVER.EXE 

RUNDET.EXE 

RUNOFF.EXE 

SCSDEF.STB 

SCSLOA.EXE 

SDA.EXE 

SEARCH.EXE 

SECDMC.SYS 

SECDP.SYS 

SECDQ.SYS 

SECDU.SYS 

SECDUP.SYS 

SECDUV.SYS 

SET. EXE 



Merge Utility 

Message compiler 

MIRROR start-up procedure 

DECnet node loopback server 

Monitor Utility 

VAX-11/782 multiprocessing code 

Symbol table for MP. EXE 

Magnetic tape ancillary control process 

Network control program 

DECnet ancillary control process 

Symbol table for network definition 

DECnet logical link driver 

NML server start-up procedure 

DECnet network management listener 

Text file that can contain announcements to 

system users 
System shutdown utility 
Operator communications utility 
CI780 port driver 
System paging file 
Data file for parameter values 
RSX-11M object module patch utility 
VAX-11 image file patch utility 
PHONE start-up procedure 
Phone Utility 

RSX-11M peripheral interchange utility 
Print symbiont 
CI UDA port driver 
Queue managing utility 
CONVERT/RECLAIM image 
Remote device ACP 
File rename utility 
Message broadcasting facility 
Operator request facility 
Record Management Services 

Global definitions for VAX-11 RMS structures 
File sharing utility program 
RMS-11 file restoration utility 
RSX-11M application migration executive main 

program 
Utility that writes an RT-11 bootstrap on disk 
Remote terminal command interface 
Remote terminal driver 
Facility that runs detached images 
Text formatting utility 
Symbol table for loadable routines 
Loadable routines used by SCS 
System Dump Analyzer Utility 
File search utility 

DECnet downline secondary loader for DMC11 
DECnet downline secondary loader for DP11 
DECnet downline secondary loader for DP11 
DECnet downline secondary loader for DQ11 
DECnet downline secondary loader for DUP11 
DECnet downline secondary loader for DUV11 
SET command processor 
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Table A-l (Cont.): Files Contained in Directory [SYSEXE] 



File Name 



Description 



SETP0.EXE 

SHOW, EXE 

SHUTD0WN.COM 

SLP.EXE 

SORT32.EXE 

SOS. EXE 

SRT. EXE 

STABACKUP.EXE 

STARTUP.COM 

STARTUP. MIN 

STASYSGEN.EXE 

STOPREM.EXE 

SUBMIT.EXE 

SUMSLP.EXE 

SWAPFILE.SYS 

SYE.EXE 

SYS. EXE 

SYS. MAP 

SYS . STB 

SYSBOOT.EXE 

SYSDEF.STB* 

SYSDUMP.DMP 

SYSGEN. EXE 

SYSINIT.EXE 

SYSLOA730.EXE 

SYSLOA750.EXE 

SYSLOA780.EXE 

SYSUAF.DAT 

SYSUAF.RL2 

TCX.EXE 

TECO.EXE 1 

TERDMC.SYS 

TERDP.SYS 

TERDQ.SYS 

TERDU.SYS 

TERDUP.SYS 

TERDUV.SYS 

TFDRIVER.EXE 

TKB . EXE 

TMDRIVER.EXE 

TOC . EXE 

TSDRIVER.EXE 

TTDRIVER.EXE 

TTRDVFY.EXE 

TYPE. EXE 

UFD.EXE 

UNLOCK.EXE 

VERIFY.EXE 

VMB.EXE 

VMOUNT.EXE 

VMSHELP.EXE 

WRITEBOOT.EXE 

XADRIVER.EXE 



SET MESSAGE command processor 

SHOW command processor 

System shutdown command procedure 

RSX-llM source file editing utility 

SORT command processor 

SOS text editor 

SORT-11 utility 

Stand-alone Backup Utility 

System start-up command procedure 

System minimum start-up command procedure 

Stand-alone System Generation Utility 

Stop REMACP utility 

Batch job submission utility 

Source file editor 

System swap file 

Utility that formats the error log file 

Operating system image file 

Map of the operating system 

Global symbol table of operating system 

System bootstrap utility 

Global definitions for executive structures 

System dump file 

System Generation and Configuration Utility 

Operating system initialization image 

VAX-11/730 system image file 

VAX-11/750 system image file 

VAX-11/780 system image file 

User authorization data file 

Unmodified copy of SYSUAF.DAT 

Runoff indexing utility 

TECO text editor 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

TU78 driver 

RSX-llM task builder 

Magnetic tape driver 

Runoff table of contents utility 

TS11 Magnetic tape driver 

Terminal driver 

Auxiliary terminal driver module 

Type utility 

User file directory creation utility 

File unlock utility 

ANALYZE/DISK_STRUCTRURE image 

VAX/VMS primary bootstrap 

Volume mount utility 

Help Utility 

System volume bootblock writing utility 

Reserved for future use 



1. Not supported by DIGITAL. 
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Table A-l (Cont.): Files Contained in Directory [SYSEXE] 



File Name 



Description 



XDDRIVER.EXE 
XFDRIVER.EXE 
XFLOADER.EXE 
XGDRIVER.EXE 
XMDRIVER.EXE 

XWDRIVER.EXE 
YCDRIVER.EXE 
ZAP. EXE 



DECnet DMP-11 datalink driver 

DR32 system interconnect interface driver 

DR32 microcode loader utility 

DECnet DMF datalink driver 

DMC-11 Synchronous Communications Line Interface 

driver 

DUP-11 device driver 

DMF32 asynchronous port driver 

RSX-11M task/file octal patch utility 



1. Not supported by DIGITAL. 



Table A-2: Files Contained in Directory [SYSHLP] 



File Name 



Description 



ANLRMSHLP.HLB 

DEBUG. HLB 

DISKQUOTA.HLB 

EDFHLP.HLB 

EDTHELP.HLB 

EDTVT100.DOC 

EDTVT52.DOC 

EXAMPLES. DIR 

HELPLIB.HLB 

INSTALHLP.HLB 

MAILHELP.HLB 

NCPHELP.HLB 

PATCHHELP.HLB 

PHONEHELP.HLB 

SDA.HLB 

SYSGEN.HLB 

TECO.HLB 

UAFHELP.HLB 

VMSTLRHLP.HLB 



Help library for ANALYZE/RMS_FILE command 

Debugger help library 

Help library for Disk Quota Utility 

Help library for FDL 

EDT help library 

EDT keypad layout for VT100 

EDT keypad layout for VT52 

Examples directory 

Default (DCL) help library 

Help library for Install Utility 

Mail Utility help library 

Help library for NCP 

Help library for PATCH 

Help library for PHONE 

System Dump Analyzer help library 

Help library for SYSGEN 

TECO help library 

Help library for user authorization file 

Help library for the tailoring facility 



Table A-3: Files Contained in Directory [SYSLIB] 



File Name 



Description 



CDDSHR.EXE 
CLIMAC.REQ 



CONVSHR.EXE 

CRFSHR.EXE 

DCLTABLES.EXE 

DEBUG.EXE 

DELTA.EXE 

DELTA. OBJ 



Dummy CDD image for layered products 

Structure definitions for BLISS programs 

interfacing with the command language 

interpreter 

CONVERT, CONVERT/RECLAIM shareable image 

Cross-reference shareable image 

DCL command tables 

VAX/VMS debugging facility 

DELTA multimode debugging tool image 

Alternate VAX/VMS debugging tool 

(continued on next page) 
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Table A-3 (Cont.): Files Contained in Directory [SYSLIB] 



File Name 



Description 



DISMNTSHR.EXE 

FDLSHR.EXE 

FORDEF.FOR 

FORIOSDEF.FOR 

IMAGELIB.OLB 

LBRSHR.EXE 

LIB. MLB 

LIB.REQ 

LIBDEF.FOR 

MCRTABLES.EXE 

MOUNTSHR.EXE 

MTHDEF.FOR 

NMLSHR.EXE 

ODT.OBJ 

RMSll.ODL 

RMS11S.ODL 

RMS11X.ODL 

RMS12X.ODL 

RMSLIB.OLB 

RMSMAC.MLB 

RSXMAC.SML 

ncvc-un dvu 

RSXUSR.EXE 

RTLVECTOR.OBJ 
SCRSHR.EXE 
SIGDEF.FOR 
STARLET. MLB 
STARLET. OLB 

STARLET. REQ 

SUMSHR.EXE 
SYS LIB. OLB 
TPAMAC.REQ 

TRACE.EXE 

VMSRTL.EXE 

XFDEF.FOR 



DISMOUNT shareable image 

FDL parsing shareable image 

FORTRAN INCLUDE file: FOR$ symbols 

FORTRAN INCLUDE file: IOSTAT error codes 

System default shareable image library 

Librarian shareable image 

Operating system macro library 

Structure definitions of executive internals 

for use by BLISS programs 

FORTRAN program utility INCLUDE files 

MCR command tables 

MOUNT shareable image 

FORTRAN INCLUDE files: MATH$ symbols 

DECnet management listener shareable image 

RSX-11M debugging tool 

RMS-11 sample overlay description 

RMS-11 overlay descriptor 

RMS-11 overlay descriptor 

RMS-11 overlay descriptor 

RMS-11 object library 

RMS-11 macro library 

RSX-11M compatibility mode macro library 

unaicauic j. may c \j i- nu/\-nn a[/fi iv,uuiuii 

migration executive 

Shareable image of RSX-11M application 

migration executive 

VMSRTL.EXE vector (reserved for DIGITAL use) 

RTL terminal screen procedures shareable image 

FORTRAN program utility INCLUDE files 

System macro library 

System object library and Run-Time 

Library 

User interface structures for use by BLISS 

programs 

Source update merge shareable image 

RSX-11M object library 

Structure definitions for BLISS programs using 

TPARSE 

VAX/VMS error traceback facility 

Run-Time Library shareable image 

Definitions available for programs using DR780 

support routines 



Table A-4: Files Contained in Directory [SYSMGR] 



File Name 



Description 



ACCOUNTING.DAT 
CHARTYPE.DAT 

FORMSTYPE.DAT 

LPA11STRT.COM 



Accounting data file 

Line printer characteristics for print 

symboint 

Line printer forms description for print 

symbiont 

LPA11 site-specific start-up command procedure 
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Table A-4 (Cont.): Files Contained in Directory [SYSMGR] 



File Name 



Description 



NETICP.COM 1 

0PERAT0R.LOG 

RTTL0AD.COM 

STARTNET.COM 

SYSHUTDWN.COM 

SYSTARTUP.COM 

VMSIMAGES.COM 
VMSIMAGES.DAT 



DECnet checkout procedure 

Operator message log file 

Remote terminal loader 

DECnet start-up procedure 

Site-specific system shutdown command 

procedure 

Site-specific system start-up command 

procedure 

Invoked at start-up to install known images 

Data file for VMSIMAGES.COM 



1. Requires DECnet-VAX optional product for use. 



Table A-5 



Files Contained in Directory [SYSMSG] 



File Name 



Description 



QIOSYM.MSG 
SOS.HLP 
SYSMSG.EXE 
SYSMSG. TLB 



RSX-11M compatibility mode QIO message 

Help file for SOS text editor 

System message file 

System message file text library 



file 



Table A-6: Files Contained in Directory [SYSTEST] 



File Name 



Description 



APPEND. PIP 

DMPASRC.DMP 

DMPBYOC.DMP 

DMPDATA.DMP 

DMPDCWD.DMP 

MCLBR1.MAC 

MCLBR2.MAC 

MCLBR3.MAC 

0BJLBR1.0BJ 

0BJLBR2.0BJ 

0BJLBR3.0BJ 

PATCHED. PAT 

PATCHPAT.OBJ 

PI PDA TA. PIP 

RANDOM. FLX 

SATSSF01.EXE 

SATSSF02.EXE 
SATSSF03.EXE 
SATSSF04.EXE 
SATSSF05.EXE 
SATSSF06.EXE 
SATSSF07.EXE 



Tests PIP append function 

Master file to test ASCII mode in DMP 

Master file to test byte octal format in DMP 

Good input file for DMP test 

Master file to test decimal word format in 

DMP 

Macro to test LBR utility 

Macro to test LBR utility 

Macro to test LBR utility 

Object module to test LBR utility 

Object module to test LBR utility 

Object module to test LBR utility 

Tests PAT utility 

Patch file to test PAT utility 

Good input file for PIP test 

Tests FLX utility 

Tests for event flag services and $SETEXV 

service 

Tests for event flag services 

Tests for logical name services 

Tests for time services 

Tests for process control services 

Tests for process control services 

Tests for process control services 

(continued on next page] 
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Table A-6 (Cont.): Files Contained in Directory [SYSTEST] 



File Name 



Description 



SATSSF08. 


EXE 


Tests 


for 


SATSSF09. 


EXE 


Tests 


for 


SATSSF10. 


EXE 


Tests 


for 


SATSSF11. 


EXE 


Tests 


for 


SATSSF12. 


EXE 


Tests 


for 


SATSSF13. 


EXE 


Tests 


for 


SATSSF14. 


EXE 


Tests 


for 


SATSSF15. 


EXE 


Tests 


for 


SATSSF16. 


EXE 


Tests 


for 


SATSSF17. 


EXE 


Tests 


for 






services 


SATSSF18. 


EXE 


Tests 


for 






services 


SATSSS01. 


EXE 


Tests 


for 


SATSSS05. 


EXE 


Tests 


for 


SATSSS07. 


EXE 


Tests 


for 


SATSSS08. 


EXE 


Tests 


for 


SATSSS09. 


EXE 


Tests 


for 


SATSSS10. 


EXE 


Tests 


for 


SATSSS22. 


EXE 


Tests 


for 


SATSSS26. 


EXE 


Tests 


for 


SATSSS30. 


EXE 


Tests 


for 


SATSSS ^5 


itvt? 


Tr\ o-t-o 


^^ y 


SATSSS36. 


EXE 


Tests 


for 


SATSSS37. 


EXE 


Tests 


for 


SATSSS38. 


,EXE 


Tests 


for 


SATSSS39. 


EXE 


Tests 


for 


SATSSS40. 


EXE 


Tests 


for 


SATSSS41. 


, EXE 


Tests 


for 


SATSSS42. 


, EXE 


Tests 


for 


SATSSS43. 


, EXE 


Tests 


for 






services 


SATSSS44. 


.EXE 


Tests 


for 


SATSSS45. 


, EXE 


Tests 


for 


SATSSS46. 


.EXE 


Tests 


for 


SATSSS47, 


.EXE 


Tests 


for 


SATSSS50. 


.EXE 


Tests 


for 


SATSSS52. 


.EXE 


Tests 


for 


SATSSS53. 


• EXE 


Tests 


for 


SATSSS54, 


.EXE 


Tests 


for 


SATSSS55. 


.EXE 


Tests 


for 


SATSSS56. 


.EXE 


Tests 


for 


SATSSS60. 


.EXE 


Tests 


for 


SATSSS61. 


.EXE 


Tests 


for 


SATSSS70. 


.EXE 


Tests 


for 


SATSSS71. 


.EXE 


Tests 


for 


SATSSS72, 


.EXE 


Tests 


for 


SATSSS73. 


.EXE 


Tests 


for 


SATSSS74, 


.EXE 


Tests 


for 






disabled) 


SATSSS78, 


.EXE 


Tests 


for 


SATSSS79, 


.EXE 


Tests 


for 


SATSSS80, 


.EXE 


Tests 


for 


SATSSS81. 


.EXE 


Tests 


for 


SATSSS82, 


.EXE 


Tests 


for 


SATSSS83, 


.EXE 


Tests 


for 



$CMEXEC and $GETMSG services 

I/O services 

send system services 

I/O services 

memory management services 

memory management services 

memory management services 

handler services and $ADJ 

$FAO services and $SNDERR 

$INPUT, $OUTPUT, $QIO, and $QIOW 

$CREPRC, $SETPRV, and $UNWIND 

I/O services 
send message services 
$CREMBX, $DELMBX services 
$BRDCST service 
$FAO, $FAOL SERVICES 
$GETMSG and $PUTMSG services 
condition handling services 
timer and AST services 
logical name services 



$DELPRC service 

$SUSPND service 

$RESUME service 

$HIBER service 

$WAKE service 

$EXIT service 

$FORCEX service 

exit- and change mode-handling 

$SETPRN service 

$SETPRI service 

$SETRWM service 

$SETPRV service 

$ASCEFC, $DACEFC services 

$DLCEFC service 

$SETEF service 

$CLREF service 

$READEF service 

wait services 

time conversion services 

$SCHDWK, $CANWAK services 

$EXPREG service 

$CNTREG service 

$CRETVA service 

$DELTVA service 

global section services (currently 

$LKWSET, $ULWSET services 
$LCKPAG, $ULKPAG services 
$PURGWS service 
$ADJWSL service 
$SETPRT service 
$SETSWM service 
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Table A-6 (Cont.): Files Contained in Directory [SYSTEST] 



File Name 



Description 



SATSSS90.EXE 
SATSSS91.EXE 
SATSUT01.EXE 

SATSUT04.EXE 

SATSUT05. EXE 

SATSUT06.EXE 

SATSUT07.EXE 

SATSUT08.EXE 

SATSUT09.EXE 

SATSUT10.EXE 

SATSUT11.EXE 

SATSUT12.EXE 

SATSUT13.EXE 

SATSUT14.EXE 

SLPDATA.SLP 

SLPLIST.SLP 

SLPOUT.SLP 

SMFILE1.DAT 

SMFILE2.DAT 

SMFILE3.DAT 

SMFILE4.DAT 

SORT. DAT 

SORTED. FLX 

TST01A.EXE 

TST01B.EXE 

TST02A.EXE 

TST03A.EXE 

TST03B.EXE 

TST06A.EXE 

TST07A.EXE 
TST11A.EXE 
TST11B.EXE 
TST12A.EXE 
TST12B.EXE 
TST15A.EXE 

TST16A.EXE 

TST16B.EXE 

TST16C.EXE 

TST17A.EXE 

TST17B.EXE 

TST20A.EXE 

TST20B.EXE 

UETCOMP00.COM 



Tests for change mode services 

Tests for $ADJSTK service 

Utility module for SATSSF05, SATSSF18, and 

SATSSS35 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Utility module for 

Input data to test 



SATSSS45 



Good output 
Good output 
Master data 
Master data 
Master data 
Master data 
Input data 



file 
file 
file 
file 
file 
file 
file 



SATSSS50 

SATSSS38 

SATSSS40 

SATSSS61 

SATSSS37, 

SATSSS41 

SATSSS52 

SATSSS56 

abort feature 

SATSSS42 

SATSSS36 

SLP utility 
for SLP test 
for SLP test 
for VAX-11 SORT test 
for VAX-11 SORT test 
for VAX-11 SORT test 
for VAX-11 SORT test 
for VAX-11 SORT tests 



Tests FLX utility 

Test for QIO f QIOW (RSX-11M directive) 

Test for QIO, QIOW (RSX-11M directive) 

Test for event flags (RSX-11M directive) 

Test for GET TIME, MARK TIME, RUN (RSX-11M 

directive) 

Test for GET TIME, MARK TIME, RUN (RSX-11M 

directive) 

Test for MCR command line, specify SST vector 

table (RSX-11M directive) 

Test for AST services (RSX-11M directive) 

SUSPEND, RESUME (RSX-11M directive) 
SUSPEND, RESUME (RSX-11M directive) 
ABORT, EXIT-IF (RSX-11M directive) 
EXIT-IF (RSX-11M directive) 
LUN, GET LUN (RSX-11M 



Test 
Test 
Test 
Test 
Test 



ABORT, 
ASSIGN 



for 

for 

for 

for 

for 
directive) 

Test for CANCEL SCHEDULED requests (RSX-11M 
directive) 

Test for CANCEL SCHEDULED requests (RSX-11M 
directive) 

Test for CANCEL SCHEDULED requests (RSX-11M 
directive) 

Test for CANCEL MARK TIME request (RSX-11M 
directive) 

Test for CANCEL MARK TIME request (RSX-11M 
directive) 

Test for GET TASK PARAMS, REQUEST, RUN 
(RSX-11M directive) 

Test for GET TASK PARAMS, REQUEST, RUN 
(RSX-11M directive) 

Main script for compatibility mode utility 
tests 

(continued on next page) 
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Table A-6 (Cont.): Files Contained in Directory [SYSTEST] 



File Name 



Description 



UETCOMP00.DAT 
UETCOMP02.COM 



UETCOMS00. 
UETCSOS01. 
UETCSOS02. 
UETCSOS03. 
UETDISKOO. 
UETDMPFOO, 
UETDNETOO. 
UETDNETOO. 
UETDR1W00, 
UETDR7800, 
UETFORT01. 
UETFORT97. 
UETFORT98. 
UETFORT99. 
UETINITOO. 



EXE 
DAT 
CMD 
DAT 
EXE 
EXE 
COM 
DAT 
EXE 
EXE 
DAT 
EXE 
EXE 
EXE 
EXE 



UETINIT01.EXE 
UETLOAD00.DAT 



UETL0ADQ2. 

UETLOAD03. 

UETLOAD04. 

UETLOAD05. 

UETLOAD06. 

UETLOAD07. 

UETLOAD08. 

UETLOAD09. 

UETLOAD10. 

UETL0AD11. 

UETLOCKOO. 

UETLPAKOO. 

UETMA7800. 

UETMEMY01. 

UETNATVOO. 

UETNETSOO. 

UETNRMSOO. 

UETNRMSOO. 

UETNRMS01. 

UETNUTLOO. 

UETNUTLOO. 

UETP.COM 

UETPHASOO. 

UETSSMMOO. 

UETSUPDEV. 

UETTAPEOO. 

UETTTYSOO. 



CO.M 
COM 
COM 
COM 
COM 
COM 
COM 
COM 
COM 
COM 
EXE 
EXE 
EXE 
EXE 
DAT 
EXE 
COM 
DAT 
EXE 
DAT 
COM 

EXE 
EXE 
DAT 
EXE 
EXE 



Data file for compatibility mode utility test 

Main script for RSX-11M executive directive 

test 

DMC and DMR test file 

Data file for SOS test 

Commands for SOS test 

Known good data after SOS editing 

Disk device test 

DMP and DMF32 test file 

Command procedure for DECnet test 

Data file for DECnet test 

DR11W device test 

DR780 device test 

FORTRAN data file used by UETFORT01 

Compiled version of UETFORT01 for load test 

Compiled version of UETFORT02 for load test 

Compiled program for load test 

Gets VAX/VMS configuration and builds 

UETINIDEV.DAT 

Quick checks all devices for testability 

Controls load test with various numbers 

of users 

TTcor en r i r>t- fnr ~\r>z*r\ l-^e?-!- 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

Local lock manager test file 

LPA11-K test file 

MA780 test file 

Tests high page faulting rates in load test 

Script that runs VAX/VMS system service tests 

DECnet counter test file 

Main script for VAX-11 RMS tests 

VAX-11/RMS test data file 

Test program to exercise VAX-11 RMS functions 

Native mode utility data file 

Native mode utilities command procedure 

Main command procedure for entire UETP 

Phase controller test file 

Memory management system service test file 

Supported device data file 

Tests magnetic tapes on one controller 

Tests terminals for one controller 
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Table A-7: Files Contained in Directory [SYSUPD] 



File Name 



Description 



AUTOGEN.COM 

BLISSREQ.TLR 

B00TBLDR.COM 

B00TUPD.COM 

C0NSC0PY.COM 

DECNET.TLR 
DEVELOP. TLR 
DXC0PY.COM 



EXAMPLES. TLR 
FILETOOLS.TLR 
HELP. TLR 
LIBRARY. TLR 
LINEPAGE.COM 

LINEPAGE.DAT 
MANAGER. TLR 
MISCTOOLS.TLR 
OBSOLETE. TLR 
QUEUES. TLR 
REQUIRED. TLR 
RSX.TLR 
SETDEFB00.COM 

STABACKIT.COM 

SWAPFILES.COM 



TEXTTOOLS.TLR 

UETP.TLR 

VMSINSTAL.COM 

VMSKITBLD.COM 

VMSKITBLD.DAT 

VMSTAIL0R.COM 

VMSUPDATE.COM 



Command procedure to determine parameter values 

List of files in the BLISS tailoring group 

Multiprocessing console floppies command 

procedure 

Command procedure that updates VAX/VMS bootstrap 

file on console floppy diskette 

Command procedure that copies console floppy 

d iskette 

List of files in the DECnet tailoring group 

List of files in the DEVELOP tailoring group 

Command procedure that copies files from console 

floppy diskette and restores files to floppy 

diskette 

List of files in the EXAMPLE tailoring group 

List of files in the TOOLS tailoring group 

List of files in the HELP tailoring group 

List of files in the LIBRARY tailoring group 

Command procedure to change number of lines per 

page 

Datafile used by LINEPAGE.COM 

List of files in the MANAGER tailoring group 

List of files in the MISCTOOLS tailoring group 

List of files in the OBSOLETE tailoring group 

List of files in the QUEUES tailoring group 

List of files in the REQUIRED tailoring group 

List of files in the RSX tailoring group 

Command procedure that sets default boot command 

file 

Command procedure that builds stand-alone BACKUP 

to media 

Command procedure that creates swapping, paging, 

and system dump files of appropriate size for 

system being installed 

List of files in the TEXTTOOLS tailoring group 

List of files in the UETP tailoring group 

Command procedure to install EDTCAI and 

maintenance updates 

Command procedure that builds and copies VAX/VMS 

distribution disk 

List of files in VAX/VMS system that drives 

VMSKITBLD.COM 

Tailoring facility command procedure (supported 

only on VAX-11/730) 

System update command procedure 
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Table A-8: Files Contained in Directory [SYSHLP. EXAMPLES] 



File Name 



Description 



ADDRIVER.MAR 
C0NNECT.COM 

DRCOPY.PRM 

DRC0PYBLD.COM 

DRMAST.MAR 

DRMASTER.FOR 

DR SLAVE. FOR 

DRSLV.MAR 

GBLSECUFO.MAR 

LABCHNDEF.FOR 

LAB 10. OPT 

LABIOACQ.FOR 
LAB IOC IN. MAR 

LAB IOC IN. OPT 
LABIOCOM.FOR 

LABI0C0MP.COM 

LABIOCON.FOR 

LABI0LINK.COM 
LAB 10 PEAK. FOR 
LABIOSAMP.FOR 



LABIOSEC.FOR 
LABIOSTAT.FOR 

LABI0STRT.COM 

LABMBXDEF.FOR 

LBRDEM0.COM 

LBRDEMO.FOR 

LB RM AC. MAR 

LPATEST.FOR 

LPMULT.B32 

PEAK. FOR 

SCRFT.MAR 

TDRIVER.MAR 

TESTLABIO.FOR 

USSDISP.MAR 

USSLINK.COM 
USSTEST.MAR 

USSTSTLNK.COM 

XADRIVER.MAR 

XALINK.MAR 

XAMESSAGE.MAR 

XATEST.COM 

XATEST.FOR 

XI DRIVER. MAR 



Example device driver for AD11-K 

Command procedure that connects device for LABIO 

system 

Parameter file for DRCOPY routines 

Command procedure to build DRCOPY.EXE 

VAX-11 RMS interface for DRMASTER.FOR 

Master subroutines for DRCOPY 

Slave subroutines for DRCOPY 

VAX-11 RMS interface for DRSLAVE.FOR 

Opens file that is to be used as a global 

section for LABIO system 

Defines information associated wth each A/D for 

LABIO system 

Linker options file for linking modules to be 

used in LABIO system 

Acquires data for LABIO system 

Contains connect-to-interrupt call for LABIO 

system 

Linker options file for linking LABIO_DATA_ACQ 

Attaches a LABIO user program to the LABIO 

system modules of the LABIO system 

Command procedure to compile and assemble the 

morhil p.r r> f 1-hp T.ARTO svshpm 

Handles user requests and modifies the data base 

for LABIO system 

Command procedure to link LABIO system 

Samples channel for peak data in LABIO system 

Samples channel in intervals, reporting date, 

time, and average value on logical device for 

LABIO system 

Places LABI0_SECTI0N on page boundary 

Displays status of the A/D channels for LABIO 

system 

Command procedure to start LABIO system 

Defines mailbox block for LABIO system 

Command procedure to create Librarian DEMO. EXE 

Librarian demo (first part) 

Librarian demo (second part) 

LPA11-K test program 

Example program for line printer 

Peak selection routine in LABIO system 

Optional screen package (SCR$...in RTL) 

extension to handle foreign terminals 

Template for user-written driver 

Tests LABIO sytem 

Sample user system service dispatch 

and service examples 

Link command procedure for USSDISP 

Sample program to invoke one of the example 

user services implemented in USSDISP 

Link command procedure for USSTEST 

DR-11 driver 

Sample DR11W to DR11W link program 

DR-11 test program 

Used to set up XALINK.MAR 

Companion program for XAMESSAGE 

Example driver for parallel port on DMF32 
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APPENDIX B 
USING THE TU58 TAPE CARTRIDGE 



This appendix supplements the information on bootstrapping a VAX/VMS 
system by describing how to perform conversational and nonstop 
bootstrap operations using the stand-alone BOOT58 program on the TU58 
tape cartridge. This appendix also describes the command procedures 
stored on the console TU58 tape cartridge and how you can manipulate 
them. 



B.l WHEN TO BOOTSTRAP FROM THE TU58 TAPE CARTRIDGE 

In most cases it is quicker, easier, and recommended procedure, to 
bootstrap the system directly from the system disk. When you do, the 
microcode program must read and execute the boot block (block 0) . If 
this block is corrupted, and the rest of the disk is intact, the only 
way to safely bootstrap the system is to use stand-alone BOOT58. 
Later, you can use the WRITEBOOT utility to replace the bad boot block 
(see Section B. 6) . 



B.2 BOOTSTRAPPING THE SYSTEM USING STAND-ALONE BOOT58 

The stand-alone BOOT58 program resides on the console TU58 tape 
cartridge and is used to supplement the console subsystem's 
bootstrapping functions. When you request a bootstrap from the 
console TU58 tape cartridge (device DDAO) , the console subsystem 
microcode reads the TU58 boot block (block 0) into memory and executes 
it. The effect of executing the TU58 boot block is to load and 
transfer control to stand-alone BOOT58. 

With stand-alone BOOT58, you can bootstrap the system in either of the 
following ways: 

• Conversational — Request that SYSBOOT stop and allow you to 
modify the system parameters that configure the system. 

• Nonstop — Allow SYSBOOT to run to completion without your 
intervention. 

Stand-alone BOOT58 commands are used to request the bootstrapping of 
the system. The console TU58 tape cartridge contains a number of 
command procedures that contain the necessary stand-alone BOOT58 
commands to bootstrap the system from the console TU58 tape cartridge. 
Appendix C documents the BOOT58 commands. 
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The console TU58 tape cartridge contains these files in two sets: 

• A conversational set that bootstraps the system from the 
specified device and then stops in the SYSBOOT program to 
accept changes to the parameters used to configure the system. 
See Section B.2.1. 

• A nonstop set that bootstraps the system from the specified 
device without stopping in SYSBOOT for changes to the 
parameter values. See Section B.2.2. 

Table B-l lists the names of the bootstrap command procedures on the 
console TU58 tape cartridge. 



Table B-l: VAX/VMS Boot Command Procedures 



Type of Command Procedure 



Name of Command Procedure 



Conversational bootstrap 
from RK07 



DMOGEN 
DM1GEN 
DM2GEN 
DM3GEN 
DMAGEN 
DMBGEN 



Conversational bootstrap 
from RM03, RM80, RP06, 
RP07, or RM05 



DBOGEN 
DB1GEN 
DB2GEN 
DB3GEN 
DB4GEN 
DB4GEN 
DB5GEN 
DB6GEN 
DB7GEN 
DBAGEN 
DBBGEN 



Conversational bootstrap 
from RA60, RA80, or 
RA81, controlled by a 
UDA 



DUOGEN 



Nonstop bootstrap from 
RK07 



DM0BOO.CMD 
DM1B00.CMD 
DM2B00.CMD 
DM3B00.CMD 
DMABOO.CMD 
DMBBOO.CMD 



Nonstop bootstrap from 
RM03, RM05, RM80, RP06 
or RP07 



DB0BOO.CMD 
DB1B00.CMD 
DB2B00.CMD 
DB3B00.CMD 
DB4B00.CMD 
DB5B00.CMD 
DB6B00.CMD 
DB7B00.CMD 
DBABOO.CMD 
DBBBOO.CMD 



Nonstop bootstrap from 
RA60, RA80, RA81 



DU0BOO.CMD 
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B.2.1 Conversational Bootstrap Using Stand-Alone BOOT58 

To bootstrap the system using the stand-alone BOOT58 program and 
request that SYSBOOT stop to allow you to change parameter values, 
proceed as follows: 

1. Insert the console TU58 tape cartridge (part description: 
TU58#1 VAX-11/750 Local Console) in to the console drive. 

2. See that the rotary key switch on the processor control panel 
is set to LOCAL. 

3. Set the POWER-ON-ACTION switch to HALT. 

4. Press CTRL/P to obtain the console program prompt >>>. 

5. Enter the following console BOOT command to boot the TU58 
tape cartridge: 

>>>B DDAO 

6. In response to the BOOT58 prompt, enter the name of a command 
procedure in the following command format: 

BOOT58>@DxyGEN 

Indicates that the rest of the line contains the name of 
a command procedure located on the console TU58 tape 
cartridge. 

x 

Indicates the device type of the desired bootstrap 
volume : 

B — RM03, RM80, or RP06 
M — RK07 

y 

Indicates the unit number of the desired bootstrap device 
volume. Specify a number in the range of through 7. 

When SYSBOOT is ready to accept commands, it prompts as follows: 

SYSBOOT> 

You can now issue any one of the SYSBOOT commands listed in Chapter 5. 

If your system will not boot, you can use the following sequence of 
SYSBOOT commands to boot using default system parameter values: 

SYSBOOT> USE DEFAULT 
SYSBOOT> CONTINUE 

The following example shows a console printout obtained by 
bootstrapping the system using the stand-alone BOOT58 program and 
altering the WSMAX system parameter: 



B-3 



USING THE TU58 TAPE CARTRIDGE 



>>>B DDAO 
%% 

BOOT58>@DM0GEN 



DMO CONVERSATIONAL BOOT COMMAND FILE - DMOGEN 

BOOT FROM DMO AND STOP IN SYSBOOT TO ALTER PARAMETER VALUES 



D/G 1 

D/G 1 FFE000 

D/G 2 3FF20 

D/G 3 

D/G 4 

D/G 5 1 

D/G E 200 

LOAD VMB. EXE/START: 200 

START 200 

SYSBOOT> SET WSMAX S12 

SYSBOOT> CONTINUE 



CARTRIDGE DISK 

BASE OF UNIBUS I/O PAGE 

CSR ADDRESS OFFSET 

CONTROLLER UNIT = 

BOOT BLOCK LBN (UNUSED) 

SOFTWARE BOOT FLAGS (CONVERSATIONAL) 

ADDRESS OF WORKING MEMORY + ~X200 

LOAD PRIMARY BOOTSTRAP 

START PRIMARY BOOTSTRAP 



VAX/VMS Version V3. 2 <date hh:mm> 



Opcom, <date hh :mm :ss ,ss> , logfile initialized, operator=_OPAO: 

Login quotas - Interactive limit=64, Current interactive value=0 
SYSTEM job terminated at <date hh :mm :ss .ss> 



B.2.2 Nonstop Bootstrap Using Stand-Alone BOOT58 

To bootstrap the system using the stand-alone BOOT58 program, without 
stopping in SYSBOOT, proceed as follows: 

1. Insert the console TU58 (part description: TU58#1 VAX-11/750 
Local Console) into the console drive. 

2. See that the rotary key switch on the processor control panel 
is set to LOCAL. 

3. Set the POWER-ON-ACTION switch to HALT. 

4. Press CTRL/P to obtain the console program prompt >>>. 

5. Issue the following console BOOT command to bootstrap the 
TU58: 

>>>B DDAO 
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In response to the BOOT58 prompt, type the name 
bootstrap command procedure in the following format: 



of 



BOOT58>@DxyBOO. CMD 



Indicates that the rest of the line contains the name of 
a command procedure located on the console TU58. 



Indicates the device type of the desired bootstrap 
volume : 

B — RM03, RM80, or RP06 
M — RK07 



Indicates the unit number of the desired bootstrap 
volume. Specify a number in the range of through 7. 

Note that you can also type a command procedure in the following 
format to perform a nonstop bootstrap operation: 

BOOT58> BOOT ddcu 

Typing BOOT DM0 is equivalent to typing @DM0BOO. CMD. If you use the 
long form (that is, @DxyB00. CMD) , the contents of the command 
procedure are displayed on the console terminal. 

The following example shows a console printout obtained by 
bootstrapping the system using the command procedure DM0BOO.CMD: 

>>>B DDAO 



BOOT58>@DM0BOO.CMD 



DM0 BOOT COMMAND FILE - DM0BOO.CMD 



D/G 1 

D/G 1 FFE000 

D/G 2 3FF20 

D/G 3 

D/G 4 

D/G 5 

D/G E 200 

LOAD VMB. EXE/START: 200 

START 200 



CARTRIDGE DISK 

BASE OF UN I BUS I/O PAGE 

CSR ADDRESS OFFSET 

CONTROLLER UNIT = 

BOOT BLOCK LBN (UNUSED) 

SOFTWARE BOOT FLAGS 

ADDRESS OF WORKING MEMORY + ~X200 

LOAD PRIMARY BOOTSTRAP 

START PRIMARY BOOTSTRAP 

VAX/VMS Version V3. 2 <date hh:mm> 

Opcom, <date hh :mm:ss .ss>, logfile initialized, operator=_OPAO: 

Login quotas - Interactive limit=64, Current interactive value=0 
SYSTEM job terminated at <date hh:mm:ss.ss> 
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B.3 THE DEFAULT BOOTSTRAP COMMAND PROCEDURE 

VAX/VMS provides a command procedure named SETDEFBOO.COM that 
simplifies the copying of the default bootstrap command procedure to 
the console TU58. To use SETDEFBOO, log in under the system manager's 
account, SYSTEM, then type the following: 

$ @SYS$UPDATE:SETDEFBOO 

SETDEFBOO asks you to confirm that the TU58 is in the console drive 
and requests the name of the bootstrap command procedure that is to 
become the default: 

Is the console medium ready to be mounted? (Y/N): 
Enter name of default boot command file: 

Once you enter the name of the appropriate bootstrap command 

procedure, SETDEFBOO copies the specified bootstrap command procedure 

to DEFB00.CMD on the console TU58. When it finishes copying, 
SETDEFBOO issues the following message: 

Default boot command file now replaced with <file-name> 

Are you satisfied with this file as the default boot 
command file? (Y/N) 

If you reply NO, the procedure will ask you for the name of the 
default boot command file again. If you are satisfied with this file 
as the default boot command file, answer YES and proceed. 



B.4 REBOOTING USING THE DEFAULT BOOTSTRAP COMMAND PROCEDURE 

Under normal BOOT58 operation, you do not need to interrupt the 
bootstrapping of the system to type commands to SYSBOOT; that is, 
parameter values have been established. Rather, you can bootstrap the 
system using the default bootstrap command procedure that you copied 
to the file DEFB00.CMD. To do so, proceed as follows: 

1. Shut down the system by executing the following command 
procedure : 

$ @SYS$SYSTEM: SHUTDOWN 

This command procedure prompts for the number of minutes 
until system shutdown, the reason for the shutdown, and 
whether to spin down the disks. 

2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT THE SYSTEM," halt the processor by pressing 
CTRL/P. 

3. In response to the console prompt (>>>), type: B DDAO:. 

4. In response to the BOOT58 prompt (BOOT58>) , type: BOOT. 



B.5 COPYING FILES TO OR FROM THE CONSOLE TU58 TAPE CARTRIDGE 

Occasionally, you may want to copy files other than DEFB00.CMD from 
the console TU58, edit them, and place them back on the cartridge. 
VAX/VMS provides a command procedure named DXC0PY.COM to simplify the 
copying of text files (that is, ASCII files such as bootstrap command 
procedures) to and from the console TU58. 
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To request the execution of the command procedure DXC0PY.COM and to 
copy the files, proceed as follows: 

1. Invoke the command procedure by typing: 

$ 0SYS$UPDATE:DXCOPY 

2 5 The command procedure asks whether the console TU58 is 
mounted : 

Is the system console storage medium mounted (Y/N)?: 
Mount the TU58 and type YES. 

3. The command procedure then asks whether the copy operation is 
from the console TU58: 

Copy from console medium (Y/N)?: 

Type YES to indicate a copy from the console TU58 to the 
default directory. 

Type NO to indicate a copy from the current default directory 
to the console TU58. 

4. Finally, the command procedure requests the name of the file 
to be copied to or from the console TU58. Type the name of 
the file and press RETURN. 



B.6 WRITEBOOT UTILITY 

This section discusses the WRITEBOOT Utility, which writes a boot 
block on a bootable disk. 

The normal bootstrap operation on the VAX-11/750 is done from the boot 
block (block 0) of the system disk. If this block is corrupted, the 
system can only be bootstrapped from the TU58. Once the system is 
running again, the bad boot block can be rewritten by using the 
WRITEBOOT Utility. 

To invoke WRITEBOOT, type: 

$ RUN SYS$SYSTEM:WRITEBOOT 
WRITEBOOT will ask you three questions. The first is: 

Target system device (and boot file if not VMB.EXE):? 

Enter the name of the device on which you want to rewrite the boot 
block (DMAO for example) . The target system device should be 
specified as any VAX/VMS disk device (ddcu) : 

dd is the code name for the device type 
c is the controller designation 
u is the unit number 

For example, DMAO would be an RK07 on RK611 controller A, device 
number 0. The second question is: 

Enter VBN of boot file code (default is one) : 
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If you are rewriting the boot block, press RETURN. The third question 
is : 

Enter load address of primary bootstrap in HEX (default is 200): 

Again, if you are rewriting the boot block, press RETURN. 

WRITEBOOT will then write the boot file that you specified in the 
first line, to the address that you entered in the third line. 

NOTE 

To use WRITEBOOT you need the LOG_IO 
pr ivilege. 

The WRITEBOOT Utility may issue the following error messages. 

You lack LOG_IO privilege 

Explanation: You do not have the correct privilege to use 
WRITEBOOT. Consult with your system manager. 

You lack READ and/or WRITE access to TARGET DEVICE. DISMOUNT and reMOUNT 

Explanation: The access to the target device is limited. Check 
the write protect button. 

VBN must be >= 1 

Explanation: You cannot specify a zero as the Virtual Block 

Number (VBN) . 
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This appendix lists and describes the commands that can be entered to 
the stand-alone BOOT58 program. The commands are listed in 
alphabetical order. 

BOOT [device-name] 

Bootstraps the system from the specified device. If you omit the 
device name, the system is bootstrapped using the default 
bootstrap command procedure (DEFBOO.CMD). Note that you cannot 
enter the name of a command procedure to the BOOT command and you 
cannot specify this command within a command procedure. 

DEPOSIT [loc-qual , size-qual] location value 

Deposits a value in the specified location. The location is 
interpreted according to the location and size qualifiers. The 
location qualifier can be expressed as follows: 

/G general register 

/I internal process register 

/P physical memory 

The size qualifier can be expressed as follows: 

/B byte 

/W word 

/L longword 

If you do not specify the location and size qualifiers, the 
default values established by a previous command are used. 

EXAMINE [loc-qual, size-qual] location 

Displays the contents of the specified location. The location is 
interpreted according to the location and size qualifiers. The 
location qualifier can be expressed as follows: 

/G general register 

/I internal process register 

/P physical memory 
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The size qualifier can be expressed as follows: 

/B byte 

/W word 

/L longword 

If you do not specify the location and size qualifiers, the 
default values established by a previous command are used. 



HELP 



Displays the BOOT58 help file at the console terminal. You 
cannot specify this command within a command procedure. 

LOAD file-spec [/START:address] 

Loads a file from the bootstrap device into memory, starting at 

the address specified with the /START qualifier. If you omit the 

/START qualifier, the file is loaded into memory beginning at the 
first free address. 

START value 

Transfers control to the value specified. You generally use this 
command with the LOAD command. 

@f ile-spec 

Executes the name of the command procedure specified. You cannot 
specify a command procedure file-spec of more than six 
characters, nor can you specify nested command procedures. 
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MICRO VERIFY ERROR CHARACTERS 



Micro verify routines test the reliability of the VAX-11/750 hardware. 
At the start of the micro verify routines, a percent sign (%) is 
displayed at the console terminal. If the routines run successfully, 
a second percent sign is displayed after the first percent sign. If, 
however, an error is detected while the routines are running, a single 
error character is displayed in place of the second percent sign and 
the processor is halted in console mode. 

Table D-l lists the possible micro verify error characters and names 
the micro verify routines associated with those characters. 

Table D-l: Micro Verify Error Characters 



Error Character Routine Name 

@ R-BUS, W-BUS, D-REG TEST 

CACHE TEST 

[ TB PARITY CHECKER 

] CONTROL STORE PARITY CHECKER 

C M-BUS, C-REG TEST 

E SCRATCH PAD TEST 

F SCRATCH PAD EXPLICIT ADDR MTEMPS 

I SCRATCH PAD EXPLICIT ADDR RTEMPS 

J SCRATCH PAD EXPLICIT ADDR IPRS 

L SCRATCH PAD EXPLICIT ADDR GPRS 

L SCRATCH PAD DUAL PORT ADDRESS 

XB, IR, OSR TEST 

Q EX, PC_PC+ISIZE TEST 

R DSIZE TEST 

T DSIZE TEST 

X CACHE PARITY CHECKER 



D-l 



APPENDIX E 
INSTALLING OPTIONAL SOFTWARE PRODUCTS 



The procedure for performing optional software installations is 
automated, and thus requires little involvement on your part beyond 
(1) setting up the proper conditions for the installation and (2) 
responding to queries and prompting messages displayed as the 
installation proceeds. 

The VMSUPDATE.COM procedure drives optional software installations. 
Once invoked, it uses command procedures contained in the distribution 
media. These command procedures direct the installation procedure by 
means of queries and instructions sent to the terminal. Most queries 
require simple YES or NO answers. You respond with Y or N, as 
appropr iate . 



E.l DISTRIBUTION KITS 

Optional software installations for the VAX-11/750 are distributed on 
TU58 cartridges (one or more depending on the installation) . 

Each TU58 is labeled with both a name and a serial number that 
differentiates it from others in the distribution kit. Check that 
your kit contains all the cartridges listed in the bill of materials. 



E.2 PREPARATIONS FOR AN OPTIONAL SOFTWARE INSTALLATION 

To prepare for the installation, do the following: 

1. Back up your system disk (see Section 3.6). Optional 
software products may delete older product versions before 
installing new ones, so it is advisable to back up your 
system disk before attempting any software installation. It 
is also advisable because a system failure at a critical 
point of the installation could leave unusable files. 

2. Log in at the console terminal under the system manager's 
account, SYSTEM. 

(If the SYSGEN parameters MOUNTMSG or DISMOUMSG at your site 
have been set to 1, you will receive a message from OPCOM 
each time a disk, tape, or TU58 is mounted or dismounted. 
These messages are normally disabled, but if they have been 
activated and you are installing from a console terminal, 
they will appear from one to thirty seconds after each mount 
or dismount.) 

3. Prevent users from gaining access to the system by executing 
the SHUTD0WN.COM command procedure. Then reboot the system. 
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4. Set the login quota to by typing: 

$ SET LOGINS/INTERACTIVE = 

5. Be sure that you have set your default to the disk that is to 
receive the update. This is typically the system disk with 
the logical name SYS$SYSROOT. 

If you are installing optional software on a system disk 
other than the disk from which you booted, you must define a 
logical name for the target disk. For example, if you are 
installing software on an RK07 disk on the first drive, issue 
the following commands: 

$ DEFINE TARGET DMA1:[SYS0.] 

$ SET DEFAULT TARGET: [SYSUPD] 

Note that not all optional software kits allow installation 
to a device other than the system disk. Consult the 
documentation that came with the optional software kit. 

6. If you are installing to the current system disk, establish 
the following default: 

$ SET DEFAULT SYS$UPDATE 



E.3 INSTALLING OPTIONAL SOFTWARE PRODUCTS 

Type the following command to initiate the installation: 

$ @VMSUPDATE 

You will receive the following message text at the terminal: 

VMS Update Procedure 

This command procedure performs VAX/VMS software updates and 
optional software installations for VAX/VMS Release 3. 
During this sequence, the standard console medium will not 
be present in the console drive. Therefore, the system may 
be vulnerable to a power failure or other fatal crash. If a 
system crash should occur during this period the update 
sequence can be restarted at the beginning of the first 
incomplete update. 

Dismount the current console medium. 

Please place the first cartridge in the console drive 

After placing the TU58 in the CSA1 drive, you will receive the 
following query: 

Are you ready to continue?: 

If you type Y, the installation proceeds. 

If you type N, the request to insert the cartridge in the drive and 
the query "Are you ready to continue?" will be repeated. 

Continuation of the update is indicated by the display of the 
messages : 

%MOUNT-I-MOUNTED , <label> mounted on CSA1: 
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These messages are followed by questions and prompts, the content of 
which depends on the product. 



E.4 INSTALLATION COMPLETION 

When the installation is completed, control is returned to the command 
procedure VMSUPDATE.COM, which sends the following messages to the 
terminal : 

Are there more kits to process?: 

If you type Y, you will receive the following request, and the 
installation procedure begins again. 

Please place the first cartridge in the console drive. 

If you have no further installations, type N. You then receive the 
following message and DCL prompt: 

Requested update sequence complete. 
$ 

The procedure is now complete. 

To transfer control of the system to the updated version of VAX/VMS, 
halt the processor and reboot the system. 

Finally, after installing an optional software product, you should 
back up the system disk. 
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APPENDIX F 
BUILDING THE VAX/VMS SOURCE KIT 



ine vAX/VMS source kit is a set of three magnetic tapes that contains 
the source files, object files, command files, language processors, 
and utilities necessary to build any of the standard components of the 
VAX/VMS operating system. (The languages and utilities used in this 
building operation are not supported by DIGITAL.) 

Before youbegin building, you must make sure there is enough disk 
space available. A single component might require up to 40,000 free 
blocks. To build the entire system you will need at least one RP06 
(or_ its equivalent) for the source kit and one RM05 (or its 
equivalent) to use as the target of the build (for object files 
listings, and so on) . J J- 1 - 1 -^, 

To^use the VAX/VMS source kit, you must mount the first reel of the 
?;" ^ tue ta P e labeled VMSRC1) and restore the file 

[SYSBLDCOMJSRCINSTAL.COM. (This command procedure, when invoked, will 
ask_ you questions in order to properly define the system buildinq 
environment.) ^ 

To mount the reel and restore the file, type the following DCL 
commands: .■ " .. 

ALLOCATE MTcn: 

MOUNT/FOREIGN MTcn: VMSRC1 

BACKUP MTcn :SYSBLDCOM/SELECT= (SRCINSTAL.COM) DBcn: [*...] 

When the file has been restored, dismount the tape. Then complete the 
source kit installation (for either a partial or the entire system 
build) by issuing the following DCL command: entire system 

@DBcn: [SYSBLDCOMjSRCINSTAL.C0M 

This invokes a command procedure to create a system build account 

Sp?fnJ?J n9 th ! „ lo 9 ical name definitions and private command 
definitions needed to set up the proper environment for a system 
build. To log in to this account, specify the username SYSTEMBUILD 
and the password CAVEAT EMPTOR. 

Finally, to obtain a general description of the source kit you can 
print a copy of the file [SYSBLDC0MjS0URCEKIT.DOC. 
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APPENDIX G 
UPGRADING THE SYSTEM 



If for some reason you have not already upgraded your system from 
Version 2.5 to Version 3.0, this appendix describes the procedure you 
should follow. 



CAUTION 

Do not attempt to apply any Version 3 
maintenance updates without first 
upgrading the system to Version 3.0. 
The upgrade works only on a Version 2.5 
system. 

All that the user needs in order to perform the upgrade is the Version 
3.0 software distribution kit and a blank TU58 cartridge. 

You should read this entire appendix before attempting to do an 
upgrade to make sure you are aware of all the requirements of the 
upgrade. 

It is important to note that the upgrade procedure will work correctly 
only as long as your system directories are consistent with those set 
up by the VAX/VMS installation procedure. If you have changed the 
names of the directories, or deleted files from them, the upgrade 
procedure may not work correctly. 

NOTE 

As part of the upgrade, the paging, 
swapping, dump, and authorization files 
are purged back to one version. 
Everything in the [SYSERR] directory is 
deleted. All operator and accounting 
logs are deleted. If you want to keep 
any logs, move them to a user directory 
before starting the upgrade. It is also 
suggested you back up your system disk 
before upgrading because some V2. 5 files 
have been made obsolete by V3.0 and will 
be deleted when you upgrade. 



G.l RESTARTABLE UPGRADE PROCEDURE 

The upgrade procedure can be restarted. The system is booted three 
times as part of the upgrade, and a restart will continue from the 
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last time the system was booted. The system manager must boot in the 
manner requested by the upgrade procedure after the last planned 
system shutdown for the upgrade to automatically continue. 

In order to make the upgrade procedure restartable at any time, the 
new Version 3.0 system files are placed in a different directory from 
the existing V2. 5 system files. Therefore, at least one set of system 
files is bootable at all times. (More information on top-level system 
directories can be found in the VAX/VMS Release Notes . ) 



G.2 PREPARING TO UPGRADE THE SYSTEM 

Log in on the console terminal under the system manager's account, 
SYSTEM. 

Because available disk space is always at a premium, remove all 
unwanted or redundant files before upgrading the system. You can 
remove them with the DCL commands DELETE or PURGE. For instance, 
because all DIGITAL optional software must be reinstalled after an 
upgrade, you can delete the existing optional software files. 

To upgrade the system, there must be a minimum of 7000 free blocks on 
the system disk. You can confirm the free block count with the 
following command: 

SHOW DEVICES device-name 

Note that during the upgrade, the system disk and the distribution kit 
cannot be moved from one device to another. 



Before upgrading your system, you must also back up the system disk to 
a scratch disk. Users who received magnetic tape distribution kits 
can use the stand-alone BACKUP procedure described in Section 3.6. 
Users who received RK07 distribution kits should back up the system 
using the stand-alone Disk Save and Compress Utility documented in the 
VAX-11 Software Installation Guide, Version 2.0 . When this is 
completed, boot the scratch disk, which wi 11 become the Version 3.0 
system disk. 

Make sure the POWER-ON-ACTION switch on the processor control panel is 
set to RESTART/BOOT. The upgrade will continue automatically after 
shutdowns as long as this switch is in the RESTART/BOOT position. 



G.3 UPGRADING VAX/VMS 

After bootstrapping your system with the new system disk, you are 
ready to begin the upgrade procedure. Proceed as follows at the 
console terminal: 

1. Set the boot device switch on the processor control panel to 
boot from the disk drive containing the new system disk. 

If you do not have a position for this device, set the boot 
device switch to position A to bootstrap from the TU58 
cartridge, and place your console TU58 in the drive in the 
processor control panel. If you are booting from the TU58, 
reply YES when the upgrade procedure asks if you want to boot 
from TU58. 

2. Log in under the system manager's account, SYSTEM. 
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3. Prevent users from logging into the system by typing: 

$ SET LOGINS/INTERACTIVE=0 

4. If you are running DECnet-VAX f shut down the network by 
typing: 

$ RUN SYS$SYSTEM:NCP 
When the NCP> prompt is displayed, type: 

SET EXECUTOR STATE OFF 
To exit from NCP, type either CTRL/Z or EXIT. 

5. Issue a STOP/QUEUE/NEXT command for batch and print queues, 
if there are any jobs in the queues. 

These queues will be initialized during the upgrade, and any 
jobs contained in the queues will be lost. 

6. Place the distribution medium in the appropriate drive and 
place the drive online. 

7. Execute the following DCL command: 

$ SET DEFAULT [SYSUPD] 



$ @VMSINSTAL 

9. You now receive a request to enter the device name of the 
drive holding the distribution kit. You must type your 
response in the format ddcu: dd is the device code, c, the 
controller letter, and u, the unit number. The upgrade 
procedure will abort if it believes the format is incorrect. 

10. At this point, the upgrade procedure displays: 

VAX/VMS V3.0 Upgrade Procedure 

A brief description of the upgrade procedure will be 
displayed, and a cautionary note about preserving files. 

The upgrade procedure then asks: 

Do you want to continue? (Y/N) : 

If you respond YES, the upgrade continues to Phase 1. 



G.3.1 Upgrade Phase 1 

The first phase of upgrade requires some user interaction. Follow the 
procedures below: 

1. The upgrade begins by informing you that the default editor 
for VAX/VMS V3.0 is EDT. The procedure then asks: 

Would you like SOS to be the default editor for the EDIT 
command, as it was in VMS V2. 0? (Y/N) 

Respond YES or NO to that question. 
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2. Next, the upgrade procedure turns off the disk quotas on the 
system disk and removes directory entries that point to 
nonexistent files. 

The procedure then asks: 

Do you want to boot from the TU58? (Y/N) 

If you do not want to boot from TU58, answer NO and proceed 
to step 9 below. 

If you set your boot device switch to boot from TU58 as 

described in Section G. 3, you must answer YES. Make sure the 

switch position is set correctly for the upgrade to 
automatically continue. 

3. At this point, a new, site-specific TU58 must be created to 
allow reboot of a kernel VAX/VMS V3.0 system. 

The upgrade procedure asks you the following question: 

DEFBOO.CMD must be set to boot from your current 
system disk. 

You must set this up if it has not been done previously. 
Do you want to do this now? (Y/N) 

This means that the DEFBOO.CMD command procedure on your old 
console TU58 must be set to boot your current system disk. 
If you have already done this, enter NO and move to step 7 
below. If you have not yet done this, enter YES and proceed 
as follows: 

4. Answer YES when you receive this message: 

Please place the system console medium in the console 
drive. Is the console medium ready to be 
mounted? (Y/N) 

5. After you type YES, you receive this message: 

%MOUNT-I -MOUNTED, CONSOLE mounted on _CSA1: 
Enter name of default boot command file: 

Enter the appropriate name in the form dduBOO.CMD. Note that 
you must not do an interactive boot. The upgrade kit is set 
with parameters that boot any system. 

6. The following is then displayed: 

Default boot command file replaced with dduBOO.CMD 

Are you satisfied with this file as the default boot 
command file? (Y/N) 

If you are satisfied with this file as the default boot 
command file, proceed. If you are not satisfied, return to 
step 1. 

7. Put your old console TU58 into drive CS1. Answer YES when 
you receive the following message: 

Is the old console TU58, CS1:, ready to 
be mounted? (Y/N) 
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The system will respond: 

%MOUNT-I -MOUNTED, mounted on _CSA1: 
The TU58 is copied to the system disk for editing. 

8. Now, put a scratch console TU58 into the console drive. (The 
blank TU58 provided with your distribution kit may be used.) 
The upgrade procedure now checks the new console TU58 for any 
defective blocks by running the Bad Block Locator Utility. 
The new console TU58 will be written just before the system 
is rebooted in order to boot from the V3. kernel system. Do 
not put your normal console media back in the console drive 
during the remainder of the upgrade procedure. 

The upgrade procedure now asks: 

Is a scratch console TU58 now in CS1:? (Y/N) : 
Answer YES. 
The system responds: 

%MOUNT-I -MOUNTED, mounted on _CSA1: 

9. The upgrade procedure now removes all VAX/VMS V2. 5 files not 
needed to complete the upgrade, and causes the V3.0 required 
save set to be copied to the system disk. BACKUP then starts 
a verification pass to make sure all the files in the save 
set have been correctly copied. 

When the verification pass is complete, the upgrade procedure 
purges the paging, swapping, dump, and authorization files 
back to one version. (Ignore any file not found messages.) 

If you are booting from the TU58, the upgrade procedure now 
initializes the new console TU58, copies unmodified files to 
the new console TU58, and sets the DEFBOO.CMD command 
procedure to boot V3. from the directory [SYSF. SYSEXE] . 
(More information on top-level system directories can be 
found in the VAX /VMS Release Notes .) 

When the upgrade procedure reaches this point, you receive 
the following message: 

System shutting down to boot a kernel V3 system. 

If you are booting from the TU58, leave the newly created 
site-specific console TU58 in the console drive for the 
remainder of the upgrade procedure. 

10. Leave the distribution kit and the system disk where they are 
for the remainder of the upgrade procedure. 

11. The SYSGEN parameters are set to boot any system. Do not 
change them during the reboot, or the upgrade may fail to 
execute properly. 

12. The system shuts down as part of the upgrade procedure. If 
you are booting from the TU58, you will have to type B after 
each reboot when the BOOT58> prompt is displayed. 
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If rebooting from the disk, after the system shutdown 
completes, type: 

CTRL/P 
B/F0000000 ddcu: 

From this point on, all reboots from the disk will execute 
without user intervention. 

At this point, a kernel V3. system is booted and announces: 

VAX/VMS Version V3.0 <date hh:mm> 

$ SET NOVER 

Continuing with VAX/VMS V3.0 Upgrade Procedure. 



G.3.2 Upgrade Phase 2 

At the beginning of the second phase of upgrade you receive this 
message : 

%OPCOM, <date hh:mm>, logfile initialized by operator 
OPAO logfile is SYS$MANAGER: OPERATOR. LOG 
%MOUNT-I-MOUNTED, VMS300 mounted on <ddcu> 

The upgrade procedure then starts a directory cleanup. This takes a 
varying amount of time depending on the number of files on the disk. 

When the directory cleanup is complete, the upgrade procedure begins 
removing the remainder of the VAX/VMS V2. 5 files. 

Next, the library save set is merged into the kernel V3.0 system. 
When this is done, BACKUP starts a verification pass. 

Then the optional save set is merged into the kernel V3.0 system. 
When this is done, BACKUP starts a verification pass. 

When the verification pass is complete, the user authorization 
accounts are modified to handle V3.0 changes. This includes providing 
each account with an ENQLM quota of at least 20 and changing default 
directories of SYS$SYSDISK and null default devices. 

At this point, the distribution kit may be removed. 



G.3.3 Upgrade Phase 3 

The third phase of the upgrade merges the VAX/VMS-distributed files 
that are commonly edited by system managers with new VAX/VMS files. 
Ignore any undefined symbol and file not found messages that appear at 
this time. 

Next, the upgrade procedure merges all the miscellaneous user files 
that exist in the old system directories into a new set of system 
directories, temporarily called [SYSF. SYSEXE] , [SYSF. SYSMGR] , and so 
on. This takes a varying amount of time, depending upon the number of 
user files. 
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G.3.4 Upgrade Phase 4 

If you are booting from TU58, you receive the following message: 

Now the new site-specific TU58 must be modified 
to allow reboot of the complete VAX/VMS V3 system. 
The new site-specific console TU58 should already 
be in CS1: . 

The new site-specific TU58 created in Phase 1 should still be in the 
console TU58 drive. 

SOS is now established as the default editor, if you previously 
requested it. 

You then receive the following message: 

System shutting down to boot the complete V3. system. 

If you are booting from TU58, leave the newly created site-specific 
console TU58 in the console drive. The system disk must remain where 
it is in order to proceed to the next phase of the upgrade. 

The system automatically reboots after the shutdown. 

Then the following appears: 

VAX/VMS Version V3. <date hh:mm> 



G.3.5 Upgrade Phase 5 

This part of the upgrade procedure creates a new site-specific SYSGEN 
parameter file, AUTOGEN.PAR. 

After a directory cleanup, and the announcement that the upgrade to 
VAX/VMS Version 3.0 is complete, several messages will appear. 

The upgrade has automatically created a new parameter file called 
AUTOGEN.PAR that combines the default values for V3.0 and the site- 
specific values you were using under V2.0. When the system reboots, 
it will be using the values contained in the AUTOGEN.PAR file. 

If you asked to boot from TU58, the upgrade procedure has also created 
a new site-specific console TU58. This TU58 should be used instead of 
your old one. 

The upgrade is complete after the reboot. 



G.4 THE AUTOGEN.PAR PARAMETER FILE 

AUTOGEN.PAR contains some SYSGEN parameter values identical to those 
used under V2.0. These are usually set by each site to values 
specific to that site. An example is REALTIME_SPTS. 

Other SYSGEN parameter values have been set to the maximum of your 
V2.0 site-specific value and the V3. default value. An example is 
INSTKPAGES. 

The remainder of the SYSGEN parameters have been handled individually 

or set to the default values for V3.0. To see which category a 

particular parameter falls in, refer to the SAVPARAMS section in 
SYS $UPDATE : AUTOGEN . COM . 

G-7 



UPGRADING THE SYSTEM 

See Section 3.4 for additional information on modifying system 
parameters . 



G.5 SPECIAL FILE HANDLING DURING UPGRADE 

After you have completed the upgrade, you may wish to remove files you 
no longer need. In order to do so, you need to know that certain 
VAX/VMS-distributed files are handled specially during the upgrade. 
These include files that may have been edited by users, and shareable 
images that may have been linked into user images. 

For the following files, the V3.0 distribution kit copy of the file is 
made an older version, and any existing V2. copies become more recent 
versions of the file: 

[SYSMGR] FORMSTYPE . DAT 
[SYSMGR] CHARTYPE . DAT 

For the next list of files, the V3. distribution kit copy of the file 
is made the latest version, and any existing V2.0 copies become older 
versions of the file: 

[SYSLIBJLBRSHR. EXE 
[SYSLIB]RSXUSR. EXE 
[SYSLIB]SUMSHR.EXE 
[SYSLIB]VMSRTL.EXE 
[SYSMGR ] STARTNET. COM 
[S YSEXE ] STARTUP. COM 
[SYSEXE] SHUTDOWN. COM 
[S YSEXE] STARTUP. MIN 
[SYSHLP]HELPLIB.HLB 

The system manager may wish to reconcile the new versions with any 
local modifications to these files before deleting the older versions. 

The upgrade procedure does not copy these files to the system disk at 
all; you are left with the older versions of these files: 

[SYSMGR] SYSTARTUP.COM 
[SYSMGR] SYSHUTDWN. COM 
[SYSEXE ] S YSUAF . DAT 
[SYSEXE]NOTICE.TXT 

The upgrade procedure may have changed the size of the following files 
to better fit a V3. system, so their use should be monitored to make 
sure they are satisfactory: 

[SYSEXE ]SYSDUMP.DMP 
[SYSEXE] PAGEF I LE. SYS 
[SYSEXE]SWAPFILE.SYS 



G.6 INSTALLED IMAGES 

As part of the upgrade, the file SYS$MANAGER: VMSIMAGES.DAT is created 
for your site. This is a combined list of files that are installed 
for enhanced system performance. Some files in this list may already 
be in your site's SYS$MANAGER: SYSTARTUP. COM file and should be 
removed . 
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APPENDIX H 
VMSINSTAL ERROR MESSAGES 



This appendix lists the error messages issued by the VMSINSTAL command 
procedure. Each message consists of an abbreviation followed by a 
text message. 

ACCOUNT, This installation creates an account named 'name 1 . 

Explanation: The product being installed has created (or 
updated) an account with the specified name. The User 
Authorization File (UAF) has been updated accordingly. 

User Action: None, this message is informational. 

ACTIVE, The following processes are still active: 

Explanation: VMSINSTAL checks to ensure that no user processes 
are active when an installation is begun. This check has failed, 
and VMSINSTAL lists those processes that are still active. 

User Action: You will be asked if you want to continue the 
installation. It is recommended that you remedy this situation 
before continuing. 

AUTOSYNC, Auto-answer file is out of sync with questions. 
AUTOFILE, question\answer 
QUESTION, question 

Explanation: You have specified the Auto-answer option, and 
VMSINSTAL is using the answers from an existing answer file. The 
question being asked by the installation procedure does not 
coincide with the next question and answer in the answer file. 

User Action: The installation procedure must have changed. 
Delete the existing answer file and begin the installation again. 

BADCONDEV, Please specify an existing console device. 

Explanation: You have specified a console device on which the 
distribution volumes are to be mounted, but the device specified 
is a console device. 

User Action: Specify an existing console device. 

BADDISDEV, Please specify a disk or tape device. 

Explanation: You have specified a device on which the 
distribution volumes are to be mounted, but the device is neither 
a disk nor a tape. 

User Action: Specify a disk or tape device. 
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BADLIBDEV, Please specify an explicit disk drive. 

Explanation: For Dual RL02 installations, you have specified a 
device on which the library disk is to be mounted, but the device 
is not a disk. 

User Action: Specify a disk device. 

CTRLY, Installation cancelled via CTRL/Y. 

Explanation: You have cancelled the installation by entering a 
CTRL/Y. 

User Action: None, this message is informational. 

DECNET, Your DECnet network is up and running. 

Explanation: VMSINSTAL checks to ensure that your DECnet 
network has been shut down when an installation is begun. This 
check has failed. 

User Action: You will be asked if you want to continue the 
installation. It is recommended that you remedy this situation 
before continuing. 

INTEGER, Please enter an integer value. 

Explanation: VMSINSTAL asked a question which must be answered 
with an integer number. 

User Action: Answer the question again, specifying an integer. 

INVOPTIONS, To specify options, parameter 3 must be the word OPTIONS. 

Explanation: If you are specifying VMSINSTAL options, the third 
parameter to VMSINSTAL must be the word OPTIONS. 

User Action: Invoke VMSINSTAL again, specifying the options in 
the correct format. 

IVPFAIL, The IVP for 'product' has failed. 

Explanation: VMSINSTAL has invoked the Installation 
Verification Procedure (IVP) for the specified product, and th« 
IVP has failed. 

User Action: If you can determine the problem and resolve it, 
then simply install the product again. Otherwise, Contact your 
local DIGITAL support representative. 

LIBDIFF, The following system and library disk files do not match. 
LIBDIFF2, You must resolve these differences before continuing. 

Explanation: For Dual RL02 systems, VMSINSTAL temporarily 
removes all nonessential system files from the system disk. 
Before doing this, however, it checks to ensure that the copies 
of these files on the system disk match those on the library- 
disk. This check has failed, and the offending files are listed. 

User Action: You must resolve the differences before reinvoking 

VMSINSTAL. 
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LOWQUOTA, One or more account quotas may be too low. 

Explanation: VMSINSTAL checks to ensure that your process 
quotas are valid when an installation is begun. This check has 
failed. 

User Action: You will be asked if you want to continue the 
installation. It is recommended that you remedy this situation 
before continuing. See Section 4.2 in this guide, 

MOVEFILES, Files will now be moved to their target directories 

Explanation: If sufficient disk space is available at the 
beginning of an installation, VMSINSTAL builds new files in a 
working directory for the optional product or update. After all 
the files are built, they are moved to their target directories. 

User Action: None, this message is informational. 

NEXTVOL, The next volume will be mounted to try again. 

Explanation: VMSINSTAL is attempting to restore a product save 
set with the Backup utility. The required save set was not 
located on the currently mounted distribution volume, so 
VMSINSTAL will examine the next volume. 

User Action: This message will be preceded by various serious 
BACKUP messages, which can be ignored. You will be asked to 
mount the next distribution volume. 

NOCONSOLE, Unknown CPU type; console volume not remounted. 

Explanation: While attempting to remount the console volume, 
VMSINSTAL could not determine what type of CPU you have. 

User Action: Contact your local DIGITAL support representative. 
NOFILE, [new] file 'file* does not exist. 

Explanation: VMSINSTAL is attempting to locate an existing (or 
perhaps new) file with the given name, but the file does not 
exist. This message should be proceeded by other messages that 
explain it in greater detail. 

User Action: If you can determine the problem and resolve it, 
then simply install the product again. Otherwise, contact your 
local DIGITAL support representative. 

NOLIBDISK, Library disk could not be mounted. 

Explanation: You were asked to mount the library disk so that 
an installation could be performed on a Dual RL02 system. For 
some reason, the library disk could not be mounted. 

User Action: Correct the situation that prevented mounting the 
library disk and begin the installation again. 
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NOPRINT, File 'file' cannot be printed. 

Explanation: The product installation required the printing of 
one or more files, but the files could not be queued for 
pr inting . 

User Action: This error is most likely caused by the fact that 
a SYS$PRINT queue is not defined at your site. If you do not 
care that the files could not be printed, then you can ignore 
this message. Otherwise, define a SYS$PRINT queue and perform 
the installation again. 

NOPROC, The kit's installation procedure is missing. 

Explanation: The main installation procedure for the product 
could not be located on the distribution volumes. 

User Action: Contact your local DIGITAL support representative. 

NOPRODS, None of the specified products were found. 

Explanation: You have specified one or more products to be 
installed from the distribution volumes, but none of the products 
exist on the volumes. 

User Action: Specify products which exist on the volumes. 

NOREINSTALL, Image 'image' could not be reinstalled. 

Explanation: VMSINSTAL was attempting to use the INSTALL 
utility to make an image known to the system. The INSTALL 
utility failed. 

User Action: This message should be preceded by a message from 
the INSTALL utility explaining the problem. Correct the problem 
and begin the installation again. 

NOSAVESET, Required saveset 'letter' does not exist. 

Explanation: The product save set with the specified letter, 
which is required for the installation, does not exist on the 
distribution volumes. 

User Action: Contact your local DIGITAL support representative. 

NOSETPRV, You are not running on an account with SETPRV privilege. 

Explanation: VMSINSTAL checks to ensure that your account has 
SETPRV privilege when an installation is begun. This check has 
failed . 

User Action: You will be asked if you want to continue the 
installation. It is recommended that you remedy this situation 
before continuing. 

NOSPACE, There are not enough blocks to restore the system disk. 

Explanation: After installation on a dual RL02 system, 
VMSINSTAL attempts to restore your system disk to its original 
tailoring configuration. However, there are not enough free 
blocks left on the system disk. 

User Action: VMSINSTAL tells you how many additional free 
blocks are required. You must make more space on the system disk 
by purging and/or deleting files. Once this is accomplished, you 
can restore the original tailoring configuration. 
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VMSINSTAL ERROR MESSAGES 

NOTSYSTEM, You are not logged in to the SYSTEM account. 

Explanation: VMSINSTAL checks to ensure that you are logged in 
to the SYSTEM account when an installation is begun. This check 
has failed. 

User Action: You will be asked if you want to continue the 
installation. It is recommended that you remedy this situation 
before continuing. 

PEAKUTIL, This product requires 'number' blocks during installation. 

Explanation: The installation procedure for the product has 
determined that there are not enough free blocks on the system 
disk to install the product. 

User Action: Make more space on the system disk by purging 
and/or deleting files, and then install the product again. 

PRODSKIP, Products that have not been installed will be skipped. 

Explanation: You have requested that multiple products be 
installed, but one of these products requires that the system be 
rebooted after its installation. In order to accomplish this, 
the remaining uninstalled products must be skipped. 

User Action: Reinstall the remaining products after the system 
is rebooted. 

REBOOT, This product requires that the system be rebooted. 

Explanation: The product that was just installed requires that 
the system be rebooted to complete the installation. 

User Action: Reboot the system after shutdown completes. 
RECORDANS, Auto-answer file will be recorded. 

Explanation: The Auto-answer options was specified when 
VMSINSTAL was invoked. No answer file exists for the product 
about to be installed, so one will be recorded. 

User Action: Answer the prompts and questions as usual. Your 
answers will be recorded. 

RECOVER, 'product' was being installed when the system crashed. 

Explanation: The specified product was being installed when the 
system crashed due to a power failure or other problem. 

User Action: You will receive additional instructions on how to 
proceed. 

RESTORE, Restoring product saveset 'letter'... 

Explanation: The specified product save set is about to be 
restored from the distribution volumes by the Backup utility. 

User Action: This message is purely informational. 
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VMSINSTAL ERROR MESSAGES 

RETAILOR, Your original tailoring environment will now be restored. 

Explanation: The tailoring files that were removed from your 
system disk for installation, will be copied back to the system 
disk. 

User Action: None, this message is informational. 

REWIND, The tape will be rewound to try again. 

Explanation: VMSINSTAL is attempting to restore a product save 
set with the Backup utility. The required save set was not 
located on the currently mounted distribution tape, but VMSINSTAL 
will rewind the tape in case the savesets were not recorded in 
order. 

User Action: This message will be preceded by various serious 
BACKUP messages, which can be ignored. 

SMALLDISK, This is a small disk system. 

Explanation: VMSINSTAL has determined that you are running a 
dual RL02 system. It will temporarily remove all nonessential 
files from the system disk in order to make room for the 
installation. 

User Action: You will receive additional instructions as to how 
to proceed. 

STEP8FAIL, The installation of 'product' has failed. 
STEP9FAIL, The installation of 'product' has failed. 

Explanation: The installation of the product has failed due to 
some unrecoverable error. 

User Action: Additional messages should precede this one. 
These messages will explain the problem in greater detail. If 
you can remedy the situation, then simply install the product 
again. Otherwise, contact your local DIGITAL support 
representative. 

SYSDIR, This product creates system directory 'directory'. 

Explanation: The product being installed creates the specified 
system directory. 

User Action: This message is purely informational. 

SYSDISK, This product creates system disk directory 'directory'. 

Explanation: The product being installed creates a directory on 
the system disk. 

User Action: This message is purely informational. 
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VMSINSTAL ERROR MESSAGES 

TAMPER, File 'file' has been tampered with. 

Explanation: VMSINSTAL is attempting to update a system text 
file, but the file has been modified locally. The update cannot 
be performed. 

User Action: If you modify system text files, then they cannot 
be updated by DIGITAL software installations. 

UNEXPECTED, Installation terminated due to unexpected event. 

Explanation: Some unexpected event has caused the immediate 
termination of VMSINSTAL. This message should be preceded by 
other messages that explain the problem in greater detail. 

User Action: If you can determine the problem and resolve it, 
then simply install the product again. Otherwise, contact your 
local DIGITAL support representative. 

UPDATED, File 'file' is already updated. 

Explanation: VMSINSTAL is attempting to update a system text 
file, but the file has already been updated successfully. 

User Action: This message is purely informational. 

USEANS, Auto-answer file will be used. 

VMSINSTAL was invoked. An answer file exists for the product 
about to be installed, so the recorded answers will be used. 

User Action: You will not have to answer prompts and questions 
displayed by the product. If you want to record new answers, 
then you must delete the answer file and install the product with 
the Auto-answer option. 

VMIORIG, VMIORIG.TLR still exists; please see your documentation. 

Explanation: When performing an installation on a Dual RL02 
system, VMSINSTAL records the current tailoring configuration and 
then removes it from the system disk temporarily. The 
configuration is recorded in the file SYS$UPDATE: VMIORIG. TLR. 
After installation, VMSINSTAL restores the configuration and 
deletes VMIORIG.TLR. If, however, the system crashes during the 
installation, then you must restore the configuration and delete 
the file manually. 

User Action: Because VMIORIG.TLR still exists, VMSINSTAL 
assumes that you have not restored your tailoring configuration. 
You must do so, and then delete VMIORIG.TLR. 

YESNO, Please enter YES or NO. 

Explanation: VMSINSTAL asked a question which must be answered 
with YES or NO. 

User Action: Answer the question again, specifying YES or NO. 
You may abbreviate these as Y or N. 
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PCS 750 INSTALLATION PROCEDURE 



INSTALLATION PROCEDURE 

To install the PCS (Patchable Control Store) boar$ t follow the 
procedure below: 

1. Remove the L0005 from slot 5. 

2. Install the L0008 in slot 5. 

a. If you are removing the L0005 without the WCS daughter 
board, install an L0008-YA. 

b. If you are removing the L0005 with the WCS daughter 
board, install an L0008-YB. 



DIAGNOSTICS 

1. Power up the system. 

2. Boot the Diagnostic Supervisor to automatically load the 
PCS for testing. 

NOTE 
The minimum revision level of the 
Diagnostic Supervisor (ECSAA) that will 
load the PCS with microcode is 6.10B. 

UPDATING VMS (TO LOAD THE PCS) 

1. Boot VMS. 

NOTE 
Booting VMS will not load the PCS 
unless SYSTARTUP.COM has been updated 
to do so . 

2. Log in under the system manager account. 

3. Set the default to [SYSUPD] . 

4. Insert the PCS750KIT TU58 cassette (BE-T538A-frg) in CSAl. 

5. Type @VMSUPDATE. - £>/r £T 



NOTE 
You will be asked some questions, the 
first one being "Are you ready?" This 
is just to see if the TU58 is loaded. 
Answering "yes" will mount the TU58. 
From this point on, the command file on 
the TU58 will be run. ' 

6. Answer the two questions asked by the update command file 
program. ' 

a. Question. 1: 

If you have battery backup, do you want powerfail 
recovery? 

NOTE 
Powerfail recovery does not work at 
this time with all VMS Version 2 
systems. 

The answer to this question determines how a power 
failure is to be handled. If you have a power failure 

uuu j \j \j. uu v v i/u i. uwi jr uuv< rvuu f unc xrv^kj w x J. JL nw *. k/c 

reloaded unless the PCS device driver is included 
along with the proper command file that defines that 
device driver. 

Answering "yes" to this question means the device 
driver (PCS750DRV) will be included with the PCS 
loader utility (PCS750UTL) . Also, the command file 
PCS750RES.COM will be added to the system manager 
account ([SYSMGR]) and SYSTARTUP.COM will be appended 
to call that command file. If a power failure occurs 
with battery backup, the driver will be awakened by 
the system to reload the PCS. 

If you answer "no" to this question, the driver will 
not be included with the utility and the command file 
PCS750.COM will be added to [SYSMGR] with a call to 
that command file from SYSTARTUP.COM. 

b. Question 2: 

Do you want SYSTARTUP.COM updated to load PCS? 

This question is whether to append PCS750.COM or 
PCS750RES.COM to SYSTARTUP.COM (depending on your 
answer to Question 1) . 



Answer "yes" to this question if this is the first 
time you are running the update command to install PCS 
loaders. 

Answer "no" to this question if you are just updating 
the binary file or software, if you already have a 

call to the command files in SYSTARTUP^COM, or if you 

plan to use a different command file to load the PCS. 

VMS UPDATE CHECKS 

After the above two questions have been answered, the update 
command file will put the files in the proper locations and modify 
SYSTARTUP.COM to load the PCS upon power-up or restart. When the 
update command file is complete, do the following checks: 

1. All files named PCS*.* are deleted out of [SYSUPD] . 

2. The following are in [~S^£iiP_S] : ? ^ , A 

a. PCS750.BIN *- ' J ^ S 

b. PCS750UTL.EXE 

c. PCS750DRV.EXE Ajn 
{only if you answered "yes" to Question 1). 1*^ 

3. If you answered "yes" to Question 1: fs/0 

a. Check that PCS750RES.COM is in [SYSMGR]. 

b. Check that SYSTARTUP.COM has $ @PCS750RES 
(as the last command) . 

4. If you answered "no" to Question 1: 

a. Check that PCS750.COM is in [SYSMGR]. 

b. Check that SYSTARTUP.COM has $ @PCS750 
(as the last command) • 

5. Edit SYSTARTUP.COM so that either @PCS750 or §PCS750RES is 
near the beginning. 

6. Check that there is only one call to load the PCS from 
SYSTARTUP.COM. 

7. Reboot the system to load patches. 
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NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 
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